如何使用 Managed 程式碼呼叫Configuration Manager物件類別方法

發行項
04/04/2023

若要呼叫 SMS 提供者類別方法，請在Configuration Manager中使用ExecuteMethod方法。您會使用方法的參數填入 Dictionary 物件，而傳回值是包含方法呼叫結果的 IResultObject 物件。

注意事項

若要在物件實例上呼叫方法，請在IResultObject物件實例上使用ExecuteMethod方法。

呼叫Configuration Manager物件類別方法

設定與 SMS 提供者的連線。如需詳細資訊，請參閱 SMS 提供者基本概念。
將輸入參數建立為 Dictionary 物件。
使用 WqlConnectionManager 物件實例，呼叫 ExecuteMethod 並指定類別名稱和輸入參數。
從傳回之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;  
     }  
}

此範例方法具有下列參數：

參數	Type	描述
`connection`	- 受控： WqlConnectionManager	SMS 提供者的有效連線。
`wqlQuery`	- Managed： IResultObject	WQL 查詢字串。在此範例中， `SELECT * FROM SMS_R_System` 是有效的查詢。

正在編譯程式碼

命名空間

系統

System.Collections.Generic

System.ComponentModel

Microsoft。ConfigurationManagement.ManagementProvider

Microsoft。ConfigurationManagement.ManagementProvider.WqlQueryEngine

組件

microsoft.configurationmanagement.managementprovider

adminui.wqlqueryengine

健全的程式設計

可引發的Configuration Manager例外狀況為SmsConnectionException和SmsQueryException。這些可以與 SmsException一起攔截。

另請參閱

物件概觀如何使用 Managed 程式碼連線到Configuration Manager提供者
 如何使用 Managed 程式碼建立Configuration Manager物件
 如何使用 Managed 程式碼修改Configuration Manager物件
 如何使用 Managed 程式碼執行非同步Configuration Manager查詢
 如何使用 Managed 程式碼執行同步Configuration Manager查詢
 如何使用 Managed 程式碼讀取Configuration Manager物件

共用方式為