如何使用 Managed 程式碼建立 設定管理員 物件

若要使用受管理的 SMS 提供者建立 設定管理員 物件,請使用 WqlConnectionManager.CreateInstance 方法。 ConnectionManagerBase.CreateInstance 方法會採用必要的物件類型作為字串參數,並傳回用來填入新物件的 IResultObject 物件。 必須呼叫 IResultObject.Put 方法,才能將物件提交給 SMS 提供者。

建立 設定管理員 物件

  1. 設定與 SMS 提供者的連線。 如需詳細資訊,請參閱 SMS 提供者基礎。

  2. 使用您在步驟 1 中取得的 WqlConnectionManager 連線物件,呼叫 [CreateInstance 以建立必要的 WMI 物件,並接收其 IResultObject 物件實例。

  3. 填入 IResultObject 屬性。

  4. 將 IResultObject 認可至 SMS 提供者。

範例

下列範例示範如何在) (SMS_Package 建立並填入新的 設定管理員 套件。

如需呼叫範例程式碼的詳細資訊,請參閱 呼叫 設定管理員 程式碼片段。

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;
    }
}

此範例方法具有下列參數:

參數 Type 描述
connection 受管理: WqlConnectionManager 與 SMS 提供者的有效連線。

正在編譯程式碼

命名空間

系統

System.Collections.Generic

System.ComponentModel

Microsoft.ConfigurationManagement.ManagementProvider

Microsoft.ConfigurationManagement.ManagementProvider.WqlQueryEngine

組件

Microsoft.ConfigurationManagement.ManagementProvider

adminui.wqlqueryengine

健全的程式設計

可能引發的 設定管理員 例外狀況包括 SmsConnectionException 和 SmsQueryException。 這些可以與 SmsException 一起捕捉。

另請參閱

物件概觀

設定管理員 消極屬性

如何使用 Managed 程式碼來呼叫 設定管理員 物件類別方法

如何使用託管程式碼連線到 設定管理員 提供者

如何使用 Managed 程式碼修改 設定管理員 物件

如何使用 Managed 程式碼執行非同步 設定管理員 查詢

如何使用 Managed 程式碼執行同步 設定管理員 查詢

如何使用 Managed 程式碼讀取 設定管理員 物件

如何使用 Managed 程式碼來讀取消極屬性