マネージド コードを使用して Configuration Manager オブジェクトを変更する方法

マネージド SMS プロバイダーを使用して Configuration Manager オブジェクト インスタンスを変更するには、オブジェクトの IResultObject インターフェイスを使用して変更を行います。 次に、 IResultObject.Put メソッドを呼び出して変更を送信します。

注:

オブジェクトの IResultObject インターフェイスは、WqlConnectionManager.GetInstance メソッドまたは他のクエリによって取得できます。 非同期クエリを使用する例については、「マネージド コードを使用して非同期 Configuration Manager クエリを実行する方法」を参照してください。

Configuration Manager オブジェクトを変更するには

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

  2. 手順 1 で取得した WqlConnectionManager オブジェクトを使用して、 GetInstance を呼び出して、必要なオブジェクトの IResultObject を取得します。

  3. IResultObject を使用してオブジェクトに変更を加えます。

  4. IResultObject オブジェクトの Put メソッドを使用して、SMS プロバイダーへの変更をコミットします。

例

次の例では、指定されたパッケージ ID と説明からパッケージの説明を更新します。

サンプル コードの呼び出しの詳細については、「Configuration Manager コード スニペットの呼び出し」を参照してください。


public void ModifyPackageDescription(WqlConnectionManager connection, string packageID, string description)
{
    try
    {
        IResultObject package = connection.GetInstance(@"SMS_Package.PackageID='" + packageID + "'");
        Console.WriteLine("Package Name: " + package["Name"].StringValue);
        Console.WriteLine("Current Description: " + package["Description"].StringValue);

        package["Description"].StringValue = description;

        package.Put();

        Console.WriteLine("New description: " + package["Description"].StringValue);
    }
    catch (SmsException ex)
    {
        Console.WriteLine("Failed to get package. Error: " + ex.Message);
        throw;
    }
}

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

パラメーター 型 説明
connection WqlConnectionManager SMS プロバイダーへの有効な接続。

コードのコンパイル

名前空間

System

System.Collections.Generic

System.ComponentModel

Microsoft.ConfigurationManagement.ManagementProvider

Microsoft.ConfigurationManagement.ManagementProvider.WqlQueryEngine

Assembly

Microsoft.ConfigurationManagement.ManagementProvider

adminui.wqlqueryengine

堅牢なプログラミング

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

関連項目

オブジェクトの概要:Configuration Manager 遅延プロパティマネージド コードを使用して Configuration Manager オブジェクト クラス メソッドを呼び出す方法マネージド コードを使用して Configuration Manager プロバイダーに接続する方法マネージ コードを使用して Configuration Manager オブジェクトを作成する方法 マネージ コードを使用して非同期 Configuration Manager クエリを実行する方法マネージ コードを使用して Configuration Manager クエリを実行する方法データを読み取る方法マネージ コードを使用した Configuration Manager オブジェクト マネージ コードを使用した遅延プロパティの読み取り方法

  • Last updated on