共用方式為

如何使用 Managed 程式代碼修改 Configuration Manager 物件

若要使用受控 SMS 提供者修改 Configuration Manager 對象實例，請使用物件的 IResultObject 介面進行修改。 然後呼叫 IResultObject.Put 方法來提交變更。

注意事項

物件的 IResultObject 介面可以透過 WqlConnectionManager.GetInstance 方法或其他查詢取得。 如需使用異步查詢的範例，請參閱如何使用 Managed 程式代碼執行異步 Configuration Manager 查詢。

修改 Configuration Manager物件

  1. 設定與SMS提供者的連線。 如需詳細資訊，請參閱 How to Connect to an SMS Provider in Configuration Manager by Using Managed Code。

  2. 使用您在第一個步驟中取得的 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;
    }
}

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

參數 Type 描述
connection WqlConnectionManager SMS 提供者的有效連線。

正在編譯程式碼

命名空間

系統

System.Collections.Generic

System.ComponentModel

Microsoft.ConfigurationManagement.ManagementProvider

Microsoft.ConfigurationManagement.ManagementProvider.WqlQueryEngine

組件

microsoft.configurationmanagement.managementprovider

adminui.wqlqueryengine

健全的程式設計

可引發的 Configuration Manager 例外狀況為 SmsConnectionException 和 SmsQueryException。 這些可以與 SmsException一起攔截。

另請參閱

物件概觀Configuration Manager 延遲屬性如何使用 Managed 程式代碼呼叫 Configuration Manager 物件類別方法如何使用 Managed 程式代碼連接到 Configuration Manager 提供者如何建立Configuration Manager 物件使用 Managed 程式代碼如何使用 Managed 程式代碼執行異步 Configuration Manager 查詢如何使用 Managed 程式代碼執行同步 Configuration Manager 查詢如何讀取Configuration Manager物件使用Managed程式代碼如何使用Managed程式代碼讀取延遲屬性

  • Last updated on