マネージドコードを使用して Configuration Manager オブジェクトを読み取る方法

マネージド SMS プロバイダーを使用して Configuration Manager オブジェクトインスタンスを読み取るには、WqlConnectionManager.GetInstance を使用します。 GetInstance メソッドは、特定のオブジェクトインスタンスを識別する文字列を受け取り、オブジェクトへのアクセスに使用される IResultObject オブジェクトを返します。

次の関数例では、指定されたパッケージ ID の名前と説明を示します。

Configuration Manager オブジェクトを読み取るには

SMS プロバイダーへの接続をセットアップします。詳細については、「マネージドコードを使用して Configuration Manager で SMS プロバイダーに接続する方法」を参照してください。
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;
    }
}

この例のメソッドには、次のパラメータがあります:

パラメーター	型	説明
`Connection`	管理: `WqlConnectionManager`	SMS プロバイダーへの有効な接続。
`PackageID`	管理: `String`	有効なパッケージ ID。 SMS_Package クラスの PackageID プロパティから取得されます。

コードのコンパイル

名前空間

System

System.Collections.Generic

System.ComponentModel

Microsoft.ConfigurationManagement.ManagementProvider

Microsoft.ConfigurationManagement.ManagementProvider.WqlQueryEngine

Assembly

Microsoft.ConfigurationManagement.ManagementProvider

adminui.wqlqueryengine

堅牢なプログラミング

発生する可能性がある Configuration Manager の例外は、SmsConnectionException と SmsQueryException です。これらは SmsException と共にキャッチできます。

フィードバック

このページはお役に立ちましたか?

Last updated on 2026-08-19