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

發行項
04/04/2023

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

注意事項

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

修改Configuration Manager物件

設定與 SMS 提供者的連線。如需詳細資訊，請參閱How to Connect to an SMS Provider in Configuration Manager by Using Managed Code。
使用您在第一個步驟中取得的 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;  
    }  
}

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

參數	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提供者
 如何使用 Managed 程式碼建立Configuration Manager物件
 如何使用 Managed 程式碼執行非同步Configuration Manager查詢
 如何使用 Managed 程式碼執行同步Configuration Manager查詢
 如何使用 Managed 程式碼讀取Configuration Manager物件
 如何使用 Managed 程式碼讀取延遲屬性

共用方式為