Erstellen eines Configuration Manager-Objekts mithilfe von verwaltetem Code

  • Artikel

Um ein Configuration Manager-Objekt mithilfe des verwalteten SMS-Anbieters zu erstellen, verwenden Sie 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-Objektinstanz zu empfangen.

  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 Eigenschaften
Aufrufen einer Configuration Manager-Objektklassenmethode mithilfe von verwaltetem Code
Herstellen einer Verbindung mit einem Configuration Manager Anbieter mithilfe von verwaltetem Code
Ändern 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