Een Configuration Manager-object wijzigen met behulp van beheerde code

Artikel
04/04/2023

Als u een Configuration Manager-objectexemplaren wilt wijzigen met behulp van de beheerde SMS-provider, gebruikt u de IResultObject-interface van het object om wijzigingen aan te brengen. Vervolgens roept u de methode IResultObject.Put aan om de wijzigingen te verzenden.

Opmerking

De interface IResultObject voor een object kan worden verkregen via de methode WqlConnectionManager.GetInstance of via andere query's. Zie How to Perform an Asynchronous Configuration Manager Query using Managed Code (Een asynchrone Configuration Manager-query uitvoeren met beheerde code) voor een voorbeeld waarin asynchrone query's worden gebruikt.

Een Configuration Manager-object wijzigen

Een verbinding met de SMS-provider instellen. Zie Verbinding maken met een SMS-provider in Configuration Manager met behulp van beheerde code voor meer informatie.
Gebruik het WqlConnectionManager-object dat u in stap één verkrijgt, en roep GetInstance aan om een IResultObject voor het vereiste object op te halen.
Breng wijzigingen aan in het object met behulp van het IResultObject.
Voer de wijzigingen door in de SMS-provider met de methode Put van het IResultObject-object.

Voorbeeld

Met de volgende voorbeeldfunctie wordt de beschrijving van een pakket bijgewerkt van een opgegeven pakket-id en beschrijving.

Zie Aanroepen Configuration Manager codefragmenten voor meer informatie over het aanroepen van de voorbeeldcode.


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

Deze voorbeeldmethode heeft de volgende parameters:

Parameter	Type	Beschrijving
`connection`	`WqlConnectionManager`	Een geldige verbinding met de SMS-provider.

De code compileren

Naamruimten

Systeem

System.Collections.Generic

System.ComponentModel

Microsoft. ConfigurationManagement.ManagementProvider

Microsoft. ConfigurationManagement.ManagementProvider.WqlQueryEngine

Vergadering

microsoft.configurationmanagement.managementprovider

adminui.wqlqueryengine

Robuust programmeren

De Configuration Manager uitzonderingen die kunnen worden gegenereerd, zijn SmsConnectionException en SmsQueryException. Deze kunnen samen met SmsException worden gevangen.

Zie ook

Overzicht van objecten Configuration Manager Luie eigenschappen
Een Configuration Manager-objectklassemethode aanroepen met behulp van beheerde code
Verbinding maken met een Configuration Manager-provider met behulp van beheerde code
Een Configuration Manager-object maken met behulp van beheerde code
Een asynchrone Configuration Manager-query uitvoeren met behulp van beheerde code
Een synchrone Configuration Manager-query uitvoeren met behulp van beheerde code
Een Configuration Manager-object lezen met behulp van beheerde code
Luie eigenschappen lezen met behulp van beheerde code

Delen via