Een takenreeksgroep voor besturingssysteemimplementatie maken

Artikel
04/04/2023

Een takenreeksgroep voor de implementatie van het besturingssysteem in Configuration Manager kan worden toegevoegd aan een takenreeks door een exemplaar van de klasse SMS_TaskSequence_Group te maken. De groep wordt vervolgens toegevoegd aan de lijst met stappen van de takenreeks. De lijst met stappen is een matrix van de SMS_TaskSequence_Step afgeleide klassen. De matrix wordt opgeslagen in de eigenschap takenreeks, SMS_TaskSequenceSteps.

Een takenreeksgroep maken

Een verbinding met de SMS-provider instellen. Zie Basisprincipes van SMS-provider voor meer informatie.
Een geldig takenreeksobject (SMS_TaskSequence) verkrijgen. Zie Een takenreeks voor besturingssysteemimplementatie maken voor meer informatie.
Maak een exemplaar van de SMS_TaskSequence_Group klasse.
Vul de groep in met de juiste eigenschappen.
Werk de takenreekseigenschap bij Steps met de nieuwe groep.

Voorbeeld

Met de volgende voorbeeldmethode wordt een nieuwe groep toegevoegd aan de opgegeven takenreeks. Omdat de groep wordt toegevoegd aan het einde van de takenreeksmatrix Steps , kunt u de positie ervan wijzigen. Zie Een takenreeks voor de implementatie van een besturingssysteem opnieuw ordenen voor meer informatie.

Zie Aanroepen Configuration Manager codefragmenten voor meer informatie over het aanroepen van de voorbeeldcode.

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

Deze voorbeeldmethode heeft de volgende parameters:

Parameter	Type	Beschrijving
`connection`	-Beheerd: `WqlConnectionManager` - VBScript: SWbemServices	Een geldige verbinding met de SMS-provider.
`taskSequence`	-Beheerd: `IResultObject` - VBScript: SWbemObject	Een geldige takenreeks (`SMS_TaskSequence`). De groep wordt toegevoegd aan deze takenreeks.
`Name`	-Beheerd: `String` -Vbscript: `String`	Een naam voor de nieuwe groep.
`Description`	-Beheerd: `String` -Vbscript: `String`	Een beschrijving voor de nieuwe groep.

Parameter	Beschrijving
`connection`	Een `WqlConnectionManager` object dat een geldige verbinding met de SMS-provider is.
`taskSequence`	Een `IResultObject` die een geldige takenreeks (`SMS_TaskSequence`) is. De groep wordt toegevoegd aan deze takenreeks.
`name`	Een tekenreeksnaam voor de nieuwe groep.
`description`	Een tekenreeksbeschrijving voor de nieuwe groep.

Robuust programmeren

Zie Over Configuration Manager fouten voor meer informatie over foutafhandeling.

.NET Framework Beveiliging

Zie Configuration Manager op rollen gebaseerd beheer voor meer informatie over het beveiligen van Configuration Manager toepassingen.

Zie ook

Overzicht van objecten Een stap toevoegen aan een besturingssysteemimplementatiegroep
Verbinding maken met een SMS-provider in Configuration Manager met behulp van beheerde code
Verbinding maken met een SMS-provider in Configuration Manager met behulp van WMI
Een takenreeks voor een besturingssysteemimplementatie maken
Takenreeksoverzicht

Share via