Guide pratique pour lire une séquence de tâches à partir d’un package de séquences de tâches

Article
04/04/2023

Vous lisez une séquence de tâches à partir d’un package de séquence de tâches, dans Configuration Manager, en appelant la méthode GetSequence de la classe SMS_TaskSequencePackage. GetSequence renvoie un objet SMS_TaskSequence que vous pouvez modifier, puis replacer dans le package à l’aide de la méthode SetSequence . Pour obtenir un exemple d’utilisation de SetSequence, consultez How to Create an Operating System Deployment Task Sequence Package.

Pour lire une séquence de tâches à partir d’un package de séquence de tâches

Configurez une connexion au fournisseur SMS. Pour plus d’informations, consultez Notions de base du fournisseur SMS.
Interrogez le fournisseur SMS pour connaître la SMS_TaskSequencePackage à partir de laquelle vous souhaitez charger la séquence.
Appelez la méthode GetSequence de la classe SMS_TaskSequencePackage pour obtenir l’objet SMS_TaskSequence.
Apportez des modifications à la séquence de tâches et remettez-les dans le package à l’aide de SetSequence.

Exemple

L’exemple de méthode suivant retourne l’objet de séquence de tâches (SMS_TaskSequence) à partir du package fourni.

Pour plus d’informations sur l’appel de l’exemple de code, consultez Appel d’extraits de code Configuration Manager.

Function ReadTaskSequence(connection, taskSequencePackage)  
    ' Get the parameters object.  
    Set packageClass = connection.Get("SMS_TaskSequencePackage")  

    Set objInParam = packageClass.Methods_("GetSequence"). _  
        inParameters.SpawnInstance_()  

    ' Add the input parameters.  
     objInParam.Properties_.Item("TaskSequencePackage") =  taskSequencePackage  

    ' Get the sequence.  
     Set objOutParams = connection.ExecMethod("SMS_TaskSequencePackage", "GetSequence", objInParam)  
     Set ReadTaskSequence = objOutParams.TaskSequence  
End Function

public IResultObject ReadTaskSequence(  
    WqlConnectionManager connection,   
    IResultObject taskSequencePackage)  
{  
    IResultObject taskSequence = null;  
    try  
    {  
        Dictionary<string, object> parameters = new Dictionary<string, object>();  
        parameters.Add("TaskSequencePackage", taskSequencePackage);  

        IResultObject outParams = connection.ExecuteMethod("SMS_TaskSequencePackage", "GetSequence", parameters);  
        taskSequence = outParams.GetSingleItem("TaskSequence");  

        return taskSequence;  
    }  
    catch (Exception e)  
    {  
        Console.WriteLine("failed to hydrate: " + e.Message);  
        throw;  
    }  
}

L’exemple de méthode a les paramètres suivants :

Paramètre	Type	Description
`connection`	-Géré: `WqlConnectionManager` - VBScript : SWbemServices	- Connexion valide au fournisseur SMS.

Compilation du code

Cet exemple C# nécessite :

Espaces de noms

Système

System.Collections.Generic

System.Text

Microsoft. ConfigurationManagement.ManagementProvider

Microsoft. ConfigurationManagement.ManagementProvider.WqlQueryEngine

Assembly

microsoft.configurationmanagement.managementprovider

adminui.wqlqueryengine

Programmation robuste

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

Sécurité de .NET Framework

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

Voir aussi

Vue d’ensemble des objets Comment 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 WMI
Guide pratique pour créer un package de séquence de tâches de déploiement de système d’exploitation
Vue d’ensemble des séquences de tâches Guide pratique pour énumérer les séquences de tâches de déploiement de système d’exploitation disponibles

Partage via