マネージド SMS プロバイダを使用して同期クエリを実行するには、 WqlConnectionManager.QueryProcessor.ExecuteQuery メソッドを使用します。
ExecuteQuery メソッドは、呼び出しの WQL クエリ文字列とオプションのコンテキスト情報を受け取ります。 クエリで見つかったオブジェクトを含む IResultObject が返されます。
同期クエリを実行するには
SMS プロバイダーへの接続をセットアップします。 詳細については、「 SMS プロバイダーの基礎」を参照してください。
手順 1 で取得した WqlConnectionManager オブジェクトを使用して、 QueryProcessor オブジェクト ExecuteQuery メソッドを呼び出して SMS プロバイダーをクエリし、クエリ結果のコレクションを含む IResultObject を取得します。
例
次のコード例は、 ExecuteQuery を使用して、利用可能なパッケージの同期クエリを実行する方法を示しています。
サンプル コードの呼び出しの詳細については、「Configuration Manager コード スニペットの呼び出し」を参照してください。
public void QueryPackages(WqlConnectionManager connection)
{
try
{
IResultObject query = connection.QueryProcessor.ExecuteQuery("Select * from SMS_Package");
foreach (IResultObject o in query)
{
Console.WriteLine(o["Name"].StringValue);
o.Dispose();
}
}
catch (SmsException ex)
{
Console.WriteLine("Failed to query packages: " + ex.Message);
throw;
}
}
この例のメソッドには、次のパラメータがあります:
| パラメーター | 型 | 説明 |
|---|---|---|
connection |
管理: WqlConnectionManager |
SMS プロバイダーへの有効な接続。 |
コードのコンパイル
名前空間
System
System.Collections.Generic
System.ComponentModel
Microsoft.ConfigurationManagement.ManagementProvider
Microsoft.ConfigurationManagement.ManagementProvider.WqlQueryEngine
Assembly
Microsoft.ConfigurationManagement.ManagementProvider
adminui.wqlqueryengine
堅牢なプログラミング
発生する可能性がある Configuration Manager の例外は、SmsConnectionException と SmsQueryException です。 これらは SmsException と共にキャッチできます。
関連項目
オブジェクトの概要:Configuration Manager 遅延プロパティマネージド コードを使用して Configuration Manager オブジェクト クラス メソッドを呼び出す方法マネージド コードを使用して Configuration Manager プロバイダーに接続する方法マネージド コードを使用した Configuration Manager オブジェクト マネージ コードを使用して Configuration Manager オブジェクトを変更する方法マネージド コードを使用して非同期 Configuration Manager クエリを実行する方法Configuration Manager の読み取り方法マネージド コードを使用してオブジェクト化する マネージド コードを使用して遅延プロパティを読み取る方法Configuration Manager拡張 WMI クエリ言語Configuration Manager結果セットConfiguration Managerクエリに関する特別なクエリ