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

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

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

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

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

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

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

例

次の関数例は、指定されたパッケージ識別子と説明からパッケージの説明を更新します。

サンプル コードの呼び出しについては、「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;
    }
}

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

コードのコンパイル

名前空間

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マネージド コードを使用して遅延プロパティを読み取る方法