관리 코드를 사용하여 Configuration Manager 개체 클래스 메서드를 호출하는 방법How to Call a Configuration Manager Object Class Method by Using Managed Code

SMS 공급자 클래스 메서드를 호출 하려면 Configuration Manager ExecuteMethod 메서드를 사용 합니다.To call a SMS Provider class method, in Configuration Manager, you use the ExecuteMethod method. 메서드 매개 변수를 사용 하 여 사전 개체를 채우고 반환 값은 메서드 호출의 결과를 포함 하는 iresultobject 개체입니다.You populate a Dictionary object with the method's parameters, and the return value is an IResultObject object that contains the result of the method call.

참고

개체 인스턴스에 대해 메서드를 호출 하려면 Iresultobject 개체 인스턴스에 대해 ExecuteMethod 메서드를 사용 합니다.To call a method on an object instance, use the ExecuteMethod method on the IResultObject object instance.

Configuration Manager 개체 클래스 메서드를 호출 하려면To call a Configuration Manager object class method

  1. SMS 공급자에 대한 연결을 설정합니다.Set up a connection to the SMS Provider. 자세한 내용은 SMS 공급자 기본 사항을 참조 하세요.For more information, see SMS Provider fundamentals.

  2. 입력 매개 변수를 사전 개체로 만듭니다.Create the input parameters as a Dictionary object.

  3. WqlConnectionManager 개체 인스턴스를 사용 하 여 ExecuteMethod 를 호출 하 고 클래스 이름과 입력 매개 변수를 지정 합니다.Using the WqlConnectionManager object instance, call ExecuteMethod and specify the class name and input parameters.

  4. 반환 된 Iresultobject 개체의 ReturnValue 속성에서 메서드 반환 값을 검색 합니다.Retrieve the method return value from the ReturnValue property in the returned IResultObject object.

예제Example

다음 예제에서는 SMS_CollectionRuleQuery 클래스 validatequery 클래스 메서드를 호출 하 여 수집 규칙 쿼리의 유효성을 검사 합니다.The following example validates a collection rule query by calling the SMS_CollectionRuleQuery class ValidateQuery class method.

샘플 코드를 호출하는 방법에 대한 자세한 내용은 Configuration Manager 코드 조각 호출을 참조하세요.For information about calling the sample code, see Calling Configuration Manager Code Snippets.

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;  
     }  
}  

이 예제 메서드에는 다음과 같은 매개 변수가 있습니다.This example method has the following parameters:

매개 변수Parameter TypeType 설명Description
connection - 관리 코드: WqlConnectionManager- Managed: WqlConnectionManager SMS 공급자에 대한 유효한 연결입니다.A valid connection to the SMS Provider.
wqlQuery -관리: Iresultobject- Managed: IResultObject WQL 쿼리 문자열입니다.A WQL query string. 이 예의 경우 SELECT * FROM SMS_R_System 은 유효한 쿼리입니다.For this example, SELECT * FROM SMS_R_System is a valid query.

코드 컴파일Compiling the Code

네임스페이스Namespaces

시스템System

System.Collections.GenericSystem.Collections.Generic

System.ComponentModelSystem.ComponentModel

Microsoft.ConfigurationManagement.ManagementProviderMicrosoft.ConfigurationManagement.ManagementProvider

Microsoft.ConfigurationManagement.ManagementProvider.WqlQueryEngineMicrosoft.ConfigurationManagement.ManagementProvider.WqlQueryEngine

어셈블리Assembly

microsoft.configurationmanagement.managementprovidermicrosoft.configurationmanagement.managementprovider

adminui.wqlqueryengineadminui.wqlqueryengine

강력한 프로그래밍Robust Programming

발생할 수 있는 Configuration Manager 예외는 Smsconnectionexceptionsmsconnectionexception입니다.The Configuration Manager exceptions that can be raised are SmsConnectionException and SmsQueryException. SmsException와 함께 catch 할 수 있습니다.These can be caught together with SmsException.

참고 항목See Also

개체 개요 관리 코드를 사용 하 여 Configuration Manager 공급자에 연결 하는 방법 Objects overview How to Connect to a Configuration Manager Provider using Managed Code
관리 코드를 사용 하 여 Configuration Manager 개체를 만드는 방법 How to Create a Configuration Manager Object by Using Managed Code
관리 코드를 사용 하 여 Configuration Manager 개체를 수정 하는 방법 How to Modify a Configuration Manager Object by Using Managed Code
관리 코드를 사용 하 여 비동기 Configuration Manager 쿼리를 수행 하는 방법 How to Perform an Asynchronous Configuration Manager Query by Using Managed Code
관리 코드를 사용 하 여 동기 Configuration Manager 쿼리를 수행 하는 방법 How to Perform a Synchronous Configuration Manager Query by Using Managed Code
관리 코드를 사용 하 여 Configuration Manager 개체를 읽는 방법How to Read a Configuration Manager Object by Using Managed Code