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

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. O grupo é então 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 sequência de tarefas, SMS_TaskSequence, Steps propriedade.

Para criar um grupo de sequência de tarefas

  1. Configure uma conexão com o provedor de SMS. Para obter mais informações, consulte Conceitos básicos do Provedor SMS.

  2. Obtenha um objeto de sequência de tarefas (SMS_TaskSequence) válido. Para obter mais informações, consulte Como criar uma sequência de tarefas de implantação do sistema operacional.

  3. Crie uma instância da SMS_TaskSequence_Group classe.

  4. Preencha o grupo com as propriedades apropriadas.

  5. Atualize a propriedade de sequência Steps de 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, convém reordenar sua posição. Para obter mais informações, consulte Como reordenar uma sequência de tarefas de implantação de sistema operacional.

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

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 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 do Configuration Manager.

Segurança do .NET Framework

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

Confira também

Visão geral de objetosComo adicionar uma etapa a um grupo de implantação de sistema operacionalComo se conectar a um provedor de SMS no Configuration Manager usando código gerenciadoComo se conectar a um provedor de SMS no Configuration Manager usando o WMIComo criar uma implantação de sistema operacional Sequência de tarefasVisão geral da sequência de tarefas