Como criar um grupo de sequência de tarefas de implantação do sistema operacional

Artigo
04/04/2023

Um grupo de sequência de tarefas de implantação do sistema operacional, em Configuration Manager, pode ser adicionado a uma sequência de tarefas criando uma instância da classe SMS_TaskSequence_Group. Em seguida, o grupo é adicionado à lista de etapas da sequência de tarefas. A lista de etapas é uma matriz das classes derivadas SMS_TaskSequence_Step . A matriz é armazenada na propriedade sequência de tarefas, SMS_TaskSequence. Steps

Para criar um grupo de sequência de tarefas

Configure uma conexão com o Provedor de SMS. Para obter mais informações, confira Os fundamentos do Provedor de SMS.
Obtenha um objeto de sequência de tarefas válida (SMS_TaskSequence). Para obter mais informações, consulte Como criar uma sequência de tarefas de implantação do sistema operacional.
Crie uma instância da SMS_TaskSequence_Group classe.
Preencha o grupo com as propriedades apropriadas.
Atualize a propriedade sequência de Steps tarefas com o novo grupo.

Exemplo

O método de exemplo a seguir adiciona um novo grupo à sequência de tarefas fornecida. Como o grupo é adicionado ao final da matriz de sequência Steps de tarefas, talvez você queira reordenar sua posição. Para obter mais informações, consulte Como reordenar uma sequência de tarefas de implantação do sistema operacional.

Para obter informações sobre como chamar o código de exemplo, consulte Chamando Configuration Manager Snippets de Código.

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

Este método de exemplo tem os seguintes parâmetros:

Parâmetro	Tipo	Descrição
`connection`	-Gerenciado: `WqlConnectionManager` - VBScript: SWbemServices	Uma conexão válida com o provedor de SMS.
`taskSequence`	-Gerenciado: `IResultObject` - VBScript: SWbemObject	Uma sequência de tarefas válida (`SMS_TaskSequence`). O grupo é adicionado a essa sequência de tarefas.
`Name`	-Gerenciado: `String` -Vbscript: `String`	Um nome para o novo grupo.
`Description`	-Gerenciado: `String` -Vbscript: `String`	Uma descrição para o novo grupo.

Parâmetro	Descrição
`connection`	Um `WqlConnectionManager` objeto que é uma conexão válida com o Provedor de SMS.
`taskSequence`	Uma `IResultObject` que é uma sequência de tarefas válida (`SMS_TaskSequence`). O grupo é adicionado a essa sequência de tarefas.
`name`	Um nome de cadeia de caracteres para o novo grupo.
`description`	Uma descrição de cadeia de caracteres para o novo grupo.

Programação robusta

Para obter mais informações sobre o tratamento de erros, consulte Sobre erros de Configuration Manager.

Segurança do .NET Framework

Para obter mais informações sobre como proteger aplicativos Configuration Manager, consulte Configuration Manager administração baseada em função.

Confira também

Visão geral de objetos como adicionar uma etapa a um grupo de implantação do sistema operacional
Como se conectar a um provedor de SMS em Configuration Manager usando código gerenciado
Como se conectar a um provedor de SMS no Configuration Manager usando o WMI
Como criar uma sequência de tarefas de implantação do sistema operacional
Visão geral de sequências de tarefas

Compartilhar via