관리 코드를 사용하여 Configuration Manager 개체를 읽는 방법

관리되는 SMS 공급자를 사용하여 Configuration Manager 개체 인스턴스를 읽으려면 WqlConnectionManager.GetInstance를 사용합니다. GetInstance 메서드는 특정 개체 인스턴스를 식별하는 문자열을 사용하고 개체에 액세스하는 데 사용되는 IResultObject 개체를 반환합니다.

다음 예제 함수는 제공된 패키지 식별자에 대한 이름과 설명을 보여 있습니다.

Configuration Manager 개체를 읽으려면

1. SMS 공급자에 대한 연결을 설정합니다. 자세한 내용은 관리 코드를 사용하여 Configuration Manager SMS 공급자에 연결하는 방법을 참조하세요.

2. WqlConnectionManager 클래스 GetInstance 메서드를 호출하여 원하는 개체에 대한 IResultObject 개체를 가져옵니다.

3. IResultObject의 속성을 표시합니다.

예시

다음 코드 예제에서는 Configuration Manager 개체를 읽는 방법을 보여줍니다.

샘플 코드 호출에 대한 자세한 내용은 코드 조각 Configuration Manager 호출을 참조하세요.

public void DisplayPackageName(WqlConnectionManager connection, string packageID)  
{  
    try   
    {  
        // Get the package.  
        IResultObject package = connection.GetInstance(@"SMS_Package.PackageID='" + packageID + "'");  
        Console.WriteLine("Package Name: " + package["Name"].StringValue);  
        Console.WriteLine("Package Description: " + package["Description"].StringValue);  
    }  
    catch (SmsException ex)  
    {  
        Console.WriteLine("Failed to get package. Error: " + ex.Message);  
        throw;  
    }  
}  

이 예제 메서드에는 다음 매개 변수가 있습니다.

매개 변수	형식	설명
Connection	-관리: WqlConnectionManager	- SMS 공급자에 대한 유효한 연결입니다.
PackageID	-관리: String	유효한 패키지 식별자입니다. SMS_Package 클래스 PackageID 속성에서 가져옵니다.

코드 컴파일

네임 스페이스

시스템

System.Collections.Generic

System.ComponentModel

Microsoft. ConfigurationManagement.ManagementProvider

Microsoft. ConfigurationManagement.ManagementProvider.WqlQueryEngine

어셈블리

microsoft.configurationmanagement.managementprovider

adminui.wqlqueryengine

강력한 프로그래밍

발생할 수 있는 Configuration Manager 예외는 SmsConnectionException 및 SmsQueryException입니다. SmsException과 함께 사용할 수 있습니다.

참고 항목

개체 개요Configuration Manager 지연 속성
관리 코드를 사용하여 Configuration Manager 개체 클래스 메서드를 호출하는 방법
관리 코드를 사용하여 Configuration Manager 공급자에 연결하는 방법
관리 코드를 사용하여 Configuration Manager 개체를 만드는 방법
관리 코드를 사용하여 Configuration Manager 개체를 수정하는 방법
관리 코드를 사용하여 비동기 Configuration Manager 쿼리를 수행하는 방법
관리 코드를 사용하여 동기 Configuration Manager 쿼리를 수행하는 방법
관리 코드를 사용하여 지연 속성을 읽는 방법