次の方法で共有

マネージド コードを使用してConfiguration Manager オブジェクト クラス メソッドを呼び出す方法

  • [アーティクル]

SMS Provider クラス メソッドを呼び出すには、Configuration Managerで ExecuteMethod メソッドを使用します。 Dictionary オブジェクトにメソッドのパラメーターを設定します。戻り値は、メソッド呼び出しの結果を含む IResultObject オブジェクトです。

注:

オブジェクト インスタンスでメソッドを呼び出すには、IResultObject オブジェクト インスタンスで ExecuteMethod メソッドを使用します。

Configuration Manager オブジェクト クラス メソッドを呼び出すには

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

  2. 入力パラメーターを Dictionary オブジェクトとして作成します。

  3. WqlConnectionManager オブジェクト インスタンスを使用して ExecuteMethod を呼び出し、クラス名と入力パラメーターを指定します。

  4. 返された IResultObject オブジェクトの ReturnValue プロパティからメソッドの戻り値を取得します。

例

次の例では、 SMS_CollectionRuleQuery クラス ValidateQuery クラス メソッドを呼び出して、コレクション ルール クエリを検証 します。

サンプル コードの呼び出しについては、「Configuration Manager コード スニペットの呼び出し」を参照してください。

public void ValidateQueryRule(WqlConnectionManager connection, string wqlQuery)  
{  
    try  
    {  
        Dictionary<string,object> validateQueryParameters = new Dictionary<string,object>();  

        // Add the sql query as the WQLQuery parameter.  
        validateQueryParameters.Add("WQLQuery",wqlQuery);  

        // Call the method  
        IResultObject result=connection.ExecuteMethod("SMS_CollectionRuleQuery", "ValidateQuery", validateQueryParameters);  

        if (result["ReturnValue"].BooleanValue == true)  
        {  
            Console.WriteLine (wqlQuery + " is a valid query");  
        }  
        else  
        {  
            Console.WriteLine (wqlQuery + " is not a valid query");  
        }  
     }  
     catch (SmsException ex)  
     {  
           Console.WriteLine("Failed to validate query rule: ",ex.Message);  
           throw;  
     }  
}

この例のメソッドには、次のパラメーターがあります。

パラメーター 型 説明
connection - マネージド: WqlConnectionManager SMS プロバイダーへの有効な接続。
wqlQuery - マネージド: IResultObject WQL クエリ文字列。 この例では、 SELECT * FROM SMS_R_System 有効なクエリです。

コードのコンパイル

名前空間

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 オブジェクトを読み取る方法