マネージド コードを使用してConfiguration Manager オブジェクトを変更する方法
マネージド SMS プロバイダーを使用してConfiguration Manager オブジェクト インスタンスを変更するには、オブジェクトの IResultObject インターフェイスを使用して変更を行います。 次に、 IResultObject.Put メソッドを呼び出して変更を送信します。
注:
オブジェクトの IResultObject インターフェイスは、WqlConnectionManager.GetInstance メソッドまたはその他のクエリを使用して取得できます。 非同期クエリを使用する例については、「マネージド コードを使用して非同期Configuration Manager クエリを実行する方法」を参照してください。
Configuration Manager オブジェクトを変更するには
SMS プロバイダーへの接続を設定します。 詳細については、「マネージド コードを使用してConfiguration Managerで SMS プロバイダーに接続する方法」を参照してください。
手順 1 で取得した WqlConnectionManager オブジェクトを使用して 、GetInstance を呼び出して、必要なオブジェクトの IResultObject を取得します。
IResultObject を使用してオブジェクトに変更を加えます。
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;
}
}
この例のメソッドには、次のパラメーターがあります。
| パラメーター | 型 | 説明 |
|---|---|---|
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 オブジェクトを読み取る方法
マネージド コードを使用して遅延プロパティを読み取る方法