マネージド コードを使用して同期Configuration Manager クエリを実行する方法

マネージド SMS プロバイダーを使用して同期クエリを実行するには、 WqlConnectionManager.QueryProcessor.ExecuteQuery メソッドを 使用します。

ExecuteQuery メソッドは、呼び出しの WQL クエリ文字列と省略可能なコンテキスト情報を受け取ります。 クエリで見つかったオブジェクトを含む IResultObject が返されます。

同期クエリを実行するには

1. SMS プロバイダーへの接続を設定します。 詳細については、「 SMS プロバイダーの基礎」を参照してください。

2. 手順 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 オブジェクトを読み取る方法
マネージド コードを使用して遅延プロパティを読み取る方法
拡張 WMI クエリ言語のConfiguration Manager
結果セットのConfiguration Manager
特殊なクエリをConfiguration Managerする
クエリについて