Jak zmodyfikować obiekt Configuration Manager przy użyciu kodu zarządzanego

Artykuł
04/04/2023

Aby zmodyfikować wystąpienie obiektu Configuration Manager przy użyciu zarządzanego dostawcy programu SMS, użyj interfejsu IResultObject obiektu, aby wprowadzić modyfikacje. Następnie wywołasz metodę IResultObject.Put , aby przesłać zmiany.

Uwaga

Interfejs IResultObject dla obiektu można uzyskać za pomocą metody WqlConnectionManager.GetInstance lub innych zapytań. Przykład korzystający z zapytań asynchronicznych można znaleźć w temacie How to Perform an Asynchronous Configuration Manager Query Using Managed Code (Jak wykonać asynchroniczne zapytanie Configuration Manager przy użyciu kodu zarządzanego).

Aby zmodyfikować obiekt Configuration Manager

Skonfiguruj połączenie z dostawcą programu SMS. Aby uzyskać więcej informacji, zobacz How to Connect to an SMS Provider in Configuration Manager by Using Managed Code (Jak nawiązać połączenie z dostawcą programu SMS w Configuration Manager przy użyciu kodu zarządzanego).
Używając obiektu WqlConnectionManager , który uzyskasz w kroku 1, wywołaj polecenie GetInstance , aby uzyskać obiekt IResultObject dla wymaganego obiektu.
Wprowadź zmiany w obiekcie przy użyciu obiektu IResultObject.
Zatwierdź zmiany dostawcy programu SMS za pomocą metody Put obiektu IResultObject.

Przykład

Poniższa przykładowa funkcja aktualizuje opis pakietu z podanego identyfikatora pakietu i opisu.

Aby uzyskać informacje na temat wywoływania przykładowego kodu, zobacz Wywoływanie fragmentów kodu 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;  
    }  
}

Ta przykładowa metoda ma następujące parametry:

Parametr	Wpisać	Opis
`connection`	`WqlConnectionManager`	Prawidłowe połączenie z dostawcą programu SMS.

Kompilowanie kodu

Obszary nazw

System

System.collections.generic

System.componentmodel

Microsoft. ConfigurationManagement.ManagementProvider

Microsoft. ConfigurationManagement.ManagementProvider.WqlQueryEngine

Zestawu

microsoft.configurationmanagement.managementprovider

adminui.wqlqueryengine

Niezawodne programowanie

Wyjątki Configuration Manager, które można zgłaszać, to SmsConnectionException i SmsQueryException. Można je złapać razem z programem SmsException.

Zobacz też