Ändern eines Configuration Manager-Objekts mithilfe von verwaltetem Code

Um ein Configuration Manager Objekt instance 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

ObjektübersichtConfiguration Manager Verzögerte EigenschaftenAufrufen einer Configuration Manager Objektklassenmethode mithilfe von verwaltetem CodeHerstellen einer Verbindung mit einem Configuration Manager Anbieter mithilfe von verwaltetem CodeVorgehensweise: Erstellen einer Configuration Manager Objekt mithilfe von verwaltetem CodeAusführen einer asynchronen Configuration Manager Abfrage mithilfe von verwaltetem CodeAusführen einer synchronen Configuration Manager Abfrage mithilfe von verwaltetem CodeVorgehensweise: Lesen einer Configuration Manager-Objekt mithilfe von verwaltetem CodeLesen verzögerter Eigenschaften mithilfe von verwaltetem Code