如何使用 Managed 程式碼讀取Configuration Manager物件

發行項
04/04/2023

若要使用受控 SMS 提供者讀取Configuration Manager物件實例，請使用WqlConnectionManager.GetInstance。 GetInstance方法會採用可識別特定物件實例的字串，並傳回用來存取物件的IResultObject物件。

下列範例函式顯示所提供套件識別碼的名稱和描述。

讀取Configuration Manager物件

設定與 SMS 提供者的連線。如需詳細資訊，請參閱How to Connect to an SMS Provider in Configuration Manager by Using Managed Code。
呼叫 WqlConnectionManager 類別 GetInstance 方法，以取得所要物件的 IResultObject 物件。
顯示 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;  
    }  
}

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

參數	Type	描述
`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延遲屬性
 如何使用 Managed 程式碼呼叫Configuration Manager物件類別方法
 如何使用 Managed 程式碼連線到Configuration Manager提供者
 如何使用 Managed 程式碼建立Configuration Manager物件
 如何使用 Managed 程式碼修改Configuration Manager物件
 如何使用 Managed 程式碼執行非同步Configuration Manager查詢
 如何使用 Managed 程式碼執行同步Configuration Manager查詢
 如何使用 Managed 程式碼讀取延遲屬性

共用方式為