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

マネージド SMS プロバイダーを使用して Configuration Manager オブジェクトを作成するには、WqlConnectionManager.CreateInstance メソッドを使用します。 ConnectionManagerBase.CreateInstance メソッドは、必要なオブジェクト型を文字列パラメーターとして受け取り、新しいオブジェクトを設定するために使用される IResultObject オブジェクトを返します。 オブジェクトを SMS プロバイダーに送信するには、 IResultObject.Put メソッドを呼び出す必要があります。

Configuration Manager オブジェクトを作成するには

  1. SMS プロバイダーへの接続をセットアップします。 詳細については、「 SMS プロバイダーの基礎」を参照してください。

  2. 手順 1 で取得した WqlConnectionManager 接続オブジェクトを使用して、[ CreateInstance を呼び出して必要な WMI オブジェクトを作成し、その IResultObject オブジェクト インスタンスを受け取ります。

  3. IResultObject プロパティを設定します。

  4. IResultObject を SMS プロバイダーにコミットします。

次の例は、新しいConfiguration Manager パッケージ (SMS_Package) を作成してデータを設定する方法を示しています。

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

public void CreatePackage(WqlConnectionManager connection)
{
    try
    {
        IResultObject package = connection.CreateInstance("SMS_Package");
        package["Name"].StringValue = "Test Package";
        package["Description"].StringValue = "A test package";
        package["PkgSourcePath"].StringValue = @"c:\Package Source";

        package.Put();
    }

    catch (SmsException ex)
    {
        Console.WriteLine("Failed to create 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 の例外は、SmsConnectionExceptionSmsQueryException です。 これらは SmsException と共にキャッチできます。

関連項目

オブジェクトの概要

Configuration Manager の遅延プロパティ

マネージ コードを使用して Configuration Manager オブジェクト クラス メソッドを呼び出す方法

マネージド コードを使用して Configuration Manager プロバイダーに接続する方法

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

マネージ コードを使用して非同期 Configuration Manager クエリを実行する方法

マネージド コードを使用して同期 Configuration Manager クエリを実行する方法

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

マネージド コードを使用して遅延プロパティを読み取る方法