Procédure pour créer un groupe de séquences de tâches de déploiement de système d’exploitation

Un groupe de séquences de tâches de déploiement de système d’exploitation, dans Configuration Manager, peut être ajouté à une séquence de tâches en créant un instance de la classe SMS_TaskSequence_Group. Le groupe est ensuite ajouté à la liste des étapes de la séquence de tâches. La liste des étapes est un tableau des classes dérivées SMS_TaskSequence_Step . Le tableau est stocké dans la séquence de tâches, SMS_TaskSequence, Steps la propriété.

Pour créer un groupe de séquences de tâches

  1. Établissez une connexion au fournisseur SMS. Pour plus d’informations, consultez Principes de base du fournisseur SMS.

  2. Obtenez un objet de séquence de tâches (SMS_TaskSequence) valide. Pour plus d’informations, consultez Procédure pour créer une séquence de tâches de déploiement de système d’exploitation.

  3. Créez une instance de la SMS_TaskSequence_Group classe.

  4. Remplissez le groupe avec les propriétés appropriées.

  5. Mettez à jour la propriété de séquence Steps de tâches avec le nouveau groupe.

Exemple

L’exemple de méthode suivant ajoute un nouveau groupe à la séquence de tâches fournie. Étant donné que le groupe est ajouté à la fin du tableau de séquences de tâches Steps , vous pouvez réorganiser sa position. Pour plus d’informations, consultez Comment réorganiser une séquence de tâches de déploiement de système d’exploitation.

Pour plus d’informations sur l’appel de l’exemple de code, consultez Appel d’extraits de code de 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;
    }
}

Cet exemple de méthode contient les paramètres suivants :

Paramètre Type Description
connection - Géré : WqlConnectionManager
- VBScript : SWbemServices
Connexion valide au fournisseur SMS.
taskSequence - Géré : IResultObject
- VBScript : SWbemObject
Une séquence de tâches valide (SMS_TaskSequence). Le groupe est ajouté à cette séquence de tâches.
Name - Géré : String
- VBScript : String
Nom du nouveau groupe.
Description - Géré : String
- VBScript : String
Description du nouveau groupe.
Paramètre Description
connection Un WqlConnectionManager objet qui est une connexion valide au fournisseur SMS.
taskSequence Une IResultObject séquence de tâches valide (SMS_TaskSequence). Le groupe est ajouté à cette séquence de tâches.
name Nom de chaîne pour le nouveau groupe.
description Description sous forme de chaîne pour le nouveau groupe.

Programmation robuste

Pour plus d’informations sur la gestion des erreurs, voir À propos des erreurs du Configuration Manager.

Sécurité de .NET Framework

Pour plus d’informations sur la sécurisation des applications Configuration Manager, voir Administration basée sur les rôles de Configuration Manager.

Voir aussi

Vue d’ensemble des objetsProcédure pour ajouter une étape à un groupe de déploiement de système d’exploitationComment se connecter à un fournisseur SMS dans Configuration Manager à l’aide de code managéComment se connecter à un fournisseur SMS dans Configuration Manager à l’aide de WMIComment créer un déploiement de système d’exploitation séquence de tâchesVue d’ensemble de la séquence de tâches