如何使用 Managed 程式碼讀取設定管理員物件

若要使用受管理的 SMS 提供者讀取設定管理員物件執行個體，請使用 WqlConnectionManager.GetInstance。 GetInstance 方法採用識別特定物件實例的字串，並傳回用來存取物件的 IResultObject 物件。

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

讀取設定管理員物件

設定與 SMS 提供者的連線。如需詳細資訊，請參閱如何使用託管程式碼連線到設定管理員中的 SMS 提供者。
呼叫 WqlConnectionManager 類別 GetInstance 方法以取得所需物件的 IResultObject 物件。
顯示 IResultObject 的屬性。

範例

下列程式碼範例示範如何讀取設定管理員物件。

如需呼叫範例程式碼的詳細資訊，請參閱呼叫設定管理員程式碼片段。

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 屬性取得。