Erstellen einer Tasksequenzgruppe für die Betriebssystembereitstellung

Artikel
04/04/2023

Eine Tasksequenzgruppe für die Betriebssystembereitstellung in Configuration Manager kann einer Tasksequenz hinzugefügt werden, indem eine Instanz der SMS_TaskSequence_Group-Klasse erstellt wird. Die Gruppe wird dann der Liste der Schritte der Tasksequenz hinzugefügt. Die Liste der Schritte ist ein Array der SMS_TaskSequence_Step abgeleiteten Klassen. Das Array wird in der Tasksequenz gespeichert, SMS_TaskSequence Eigenschaft Steps .

So erstellen Sie eine Tasksequenzgruppe

Richten Sie eine Verbindung mit dem SMS-Anbieter ein. Weitere Informationen finden Sie unter Grundlagen des SMS-Anbieters.
Rufen Sie ein gültiges Tasksequenzobjekt (SMS_TaskSequence) ab. Weitere Informationen finden Sie unter Erstellen einer Tasksequenz für die Betriebssystembereitstellung.
Erstellen Sie eine Instanz der SMS_TaskSequence_Group -Klasse.
Füllen Sie die Gruppe mit den entsprechenden Eigenschaften auf.
Aktualisieren Sie die Tasksequenzeigenschaft Steps mit der neuen Gruppe.

Beispiel

Die folgende Beispielmethode fügt der angegebenen Tasksequenz eine neue Gruppe hinzu. Da die Gruppe am Ende des Tasksequenzarrays Steps hinzugefügt wird, können Sie ihre Position neu anordnen. Weitere Informationen finden Sie unter Neuanordnen einer Tasksequenz für die Betriebssystembereitstellung.

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

Sub AddTaskSequenceGroup(connection, taskSequence, name, description)  

    Dim group    

    ' Create and populate the group.  
    Set group = connection.Get("SMS_TaskSequence_Group").SpawnInstance_  
    group.Name=name  
    group.Description=description  
    group.Enabled=True  
    group.ContinueOnError=False  

    ' Resize the task sequence steps array to hold the new group.  
    ReDim steps (UBound (taskSequence.Steps)+1)    

    ' Add the group.  
    taskSequence.Steps(UBound(steps))=group  

End Sub

public IResultObject AddTaskSequenceGroup(  
    WqlConnectionManager connection,   
    IResultObject taskSequence,   
    string name,   
    string description)  
{  
    try  
    {  
        // Create the new group.  
        IResultObject ro = connection.CreateEmbeddedObjectInstance("SMS_TaskSequence_Group");  

        ro["Name"].StringValue = name;  
        ro["Description"].StringValue = description;  
        ro["Enabled"].BooleanValue = true;  
        ro["ContinueOnError"].BooleanValue = false;  

        // Add the group to the task sequence.  
        List<IResultObject> array = taskSequence.GetArrayItems("Steps");  
        array.Add(ro);  

        // Add the new group to the end of the current steps.  
        taskSequence.SetArrayItems("Steps", array);  

        return ro;  
    }  
    catch (SmsException e)  
    {  
        Console.WriteLine("Failed to create Task Sequence: " + e.Message);  
        throw;  
    }  
}

Diese Beispielmethode weist die folgenden Parameter auf:

Parameter	Typ	Beschreibung
`connection`	-Verwalteten: `WqlConnectionManager` – VBScript: SWbemServices	Eine gültige Verbindung mit dem SMS-Anbieter.
`taskSequence`	-Verwalteten: `IResultObject` – VBScript: SWbemObject	Eine gültige Tasksequenz (`SMS_TaskSequence`). Die Gruppe wird dieser Tasksequenz hinzugefügt.
`Name`	-Verwalteten: `String` -Vbscript: `String`	Ein Name für die neue Gruppe.
`Description`	-Verwalteten: `String` -Vbscript: `String`	Eine Beschreibung für die neue Gruppe.

Parameter	Beschreibung
`connection`	Ein `WqlConnectionManager` -Objekt, das eine gültige Verbindung mit dem SMS-Anbieter darstellt.
`taskSequence`	Ein `IResultObject` , das eine gültige Tasksequenz (`SMS_TaskSequence`) ist. Die Gruppe wird dieser Tasksequenz hinzugefügt.
`name`	Ein Zeichenfolgenname für die neue Gruppe.
`description`	Eine Zeichenfolgenbeschreibung für die neue Gruppe.

Robuste Programmierung

Weitere Informationen zur Fehlerbehandlung finden Sie unter Informationen zu Configuration Manager Fehlern.

.NET Framework-Sicherheit

Weitere Informationen zum Schützen Configuration Manager Anwendungen finden Sie unter Configuration Manager rollenbasierte Verwaltung.

Siehe auch

Objektübersicht Hinzufügen eines Schritts zu einer Betriebssystembereitstellungsgruppe
Herstellen einer Verbindung mit einem SMS-Anbieter in Configuration Manager mithilfe von verwaltetem Code
Herstellen einer Verbindung mit einem SMS-Anbieter in Configuration Manager mithilfe von WMI
Erstellen einer Tasksequenz für die Betriebssystembereitstellung
Übersicht über Aufgabensequenzen

Freigeben über