Erstellen eines Configuration Manager-Objekts mithilfe von verwaltetem Code

Verwenden Sie zum Erstellen eines Configuration Manager-Objekts mithilfe des verwalteten SMS-Anbieters die WqlConnectionManager.CreateInstance-Methode. Die ConnectionManagerBase.CreateInstance-Methode verwendet den erforderlichen Objekttyp als Zeichenfolgenparameter und gibt ein IResultObject-Objekt zurück, das zum Auffüllen des neuen Objekts verwendet wird. Die IResultObject.Put-Methode muss aufgerufen werden, um das Objekt an den SMS-Anbieter zu übermitteln.

So erstellen Sie ein Configuration Manager-Objekt

1. Richten Sie eine Verbindung mit dem SMS-Anbieter ein. Weitere Informationen finden Sie unter Grundlagen des SMS-Anbieters.

2. Rufen Sie mithilfe des WqlConnectionManager-Verbindungsobjekts, das Sie in Schritt 1 abrufen, [CreateInstance auf, um das erforderliche WMI-Objekt zu erstellen und dessen IResultObject-Objekt instance zu erhalten.

3. Füllen Sie die IResultObject-Eigenschaften auf.

4. Committen Sie das IResultObject an den SMS-Anbieter.

Beispiel

Im folgenden Beispiel wird veranschaulicht, wie Sie ein neues Configuration Manager Paket (SMS_Package) erstellen und dann auffüllen.

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

public void CreatePackage(WqlConnectionManager connection)
{
    try
    {
        IResultObject package = connection.CreateInstance("SMS_Package");
        package["Name"].StringValue = "Test Package";
        package["Description"].StringValue = "A test package";
        package["PkgSourcePath"].StringValue = @"c:\Package Source";

        package.Put();
    }

    catch (SmsException ex)
    {
        Console.WriteLine("Failed to create package. Error: " + ex.Message);
        throw;
    }
}

Diese Beispielmethode weist die folgenden Parameter auf:

Parameter	Typ	Beschreibung
connection	Verwaltet: 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 EigenschaftenAufrufen einer Configuration Manager Objektklassenmethode mithilfe von verwaltetem CodeHerstellen einer Verbindung mit einem Configuration Manager Anbieter mithilfe von verwaltetem CodeVorgehensweise: Ändern 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