Ändern eines Configuration Manager-Objekts mithilfe von verwaltetem Code

  • Artikel

Um eine Configuration Manager Objektinstanz mithilfe des verwalteten SMS-Anbieters zu ändern, verwenden Sie die IResultObject-Schnittstelle des Objekts, um Änderungen vorzunehmen. Anschließend rufen Sie die IResultObject.Put-Methode auf, um die Änderungen zu übermitteln.

Hinweis

Die IResultObject-Schnittstelle für ein Objekt kann über die WqlConnectionManager.GetInstance-Methode oder über andere Abfragen abgerufen werden. Ein Beispiel, in dem asynchrone Abfragen verwendet werden, finden Sie unter Ausführen einer asynchronen Configuration Manager Abfrage mit verwaltetem Code.

So ändern Sie ein Configuration Manager-Objekt

  1. Richten Sie eine Verbindung mit dem SMS-Anbieter ein. Weitere Informationen finden Sie unter Herstellen einer Verbindung mit einem SMS-Anbieter in Configuration Manager mithilfe von verwaltetem Code.

  2. Rufen Sie mithilfe des WqlConnectionManager-Objekts , das Sie in Schritt 1 abrufen, GetInstance auf, um ein IResultObject für das erforderliche Objekt abzurufen.

  3. Nehmen Sie mithilfe des IResultObject Änderungen am Objekt vor.

  4. Committen Sie die Änderungen an den SMS-Anbieter mit der Put-Methode des IResultObject-Objekts.

Beispiel

Die folgende Beispielfunktion aktualisiert die Beschreibung eines Pakets aus einem angegebenen Paketbezeichner und einer Beschreibung.

Informationen zum Aufrufen des Beispielcodes finden Sie unter Aufrufen von Configuration Manager Codeausschnitten.


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

Diese Beispielmethode weist die folgenden Parameter auf:

Parameter Typ Beschreibung
connection WqlConnectionManager Eine gültige Verbindung mit dem SMS-Anbieter.

Kompilieren des Codes

Namespaces

System

System.Collections.Generic

System.ComponentModel

Microsoft. ConfigurationManagement.ManagementProvider

Microsoft. ConfigurationManagement.ManagementProvider.WqlQueryEngine

Assembly

microsoft.configurationmanagement.managementprovider

adminui.wqlqueryengine

Robuste Programmierung

Die Configuration Manager Ausnahmen, die ausgelöst werden können, sind SmsConnectionException und SmsQueryException. Diese können zusammen mit SmsException abgefangen werden.

Siehe auch

Übersicht über ObjekteConfiguration Manager Verzögerte Eigenschaften
Aufrufen einer Configuration Manager-Objektklassenmethode mithilfe von verwaltetem Code
Herstellen einer Verbindung mit einem Configuration Manager Anbieter mithilfe von verwaltetem Code
Erstellen eines Configuration Manager-Objekts mithilfe von verwaltetem Code
Ausführen einer asynchronen Configuration Manager Abfrage mithilfe von verwaltetem Code
Ausführen einer synchronen Configuration Manager Abfrage mithilfe von verwaltetem Code
Lesen eines Configuration Manager-Objekts mithilfe von verwaltetem Code
Lesen verzögerter Eigenschaften mithilfe von verwaltetem Code