Déboguer une séquence de tâches

  • Article

S’applique à : Gestionnaire de Configuration (branche actuelle)

Le débogueur de séquence de tâches est un outil de résolution des problèmes. Vous déployez une séquence de tâches en mode débogage sur une petite collection. Il vous permet de parcourir la séquence de tâches de manière contrôlée pour faciliter la résolution des problèmes et l’investigation. Le débogueur s’exécute actuellement sur le même appareil que le moteur de séquence de tâches. Il ne s’agit pas d’un débogueur distant.

Conseil

Cette fonctionnalité a été introduite pour la première fois dans la version 1906 en tant que fonctionnalité en préversion. À compter de la version 2203, il ne s’agit plus d’une fonctionnalité en préversion.

Configuration Manager n’active pas cette fonctionnalité facultative par défaut. Avant de l’utiliser, vous devez activer cette fonctionnalité. Pour plus d’informations, consultez Activer les fonctionnalités facultatives des mises à jour.

Conditions préalables

  • Mettre à jour le client Configuration Manager sur l’appareil cible

  • Connectez-vous à l’appareil cible en tant qu’utilisateur dans le groupe Administrateurs local. Le débogueur s’exécute uniquement pour les administrateurs.

  • Mettez à jour l’image de démarrage associée à la séquence de tâches pour vous assurer qu’elle dispose de la dernière version du client

Démarrer l’outil

  1. Dans la console Configuration Manager, accédez à l’espace de travail Bibliothèque de logiciels, développez Systèmes d’exploitation, puis sélectionnez Séquences de tâches.

  2. Sélectionnez une séquence de tâches. Dans le groupe Déploiement du ruban, sélectionnez Déboguer.

    Conseil

    Vous pouvez également définir la variable TSDebugModeTRUE sur un objet de collection ou d’ordinateur sur lequel la séquence de tâches est déployée. Tout appareil sur lequel cette variable est définie place toute séquence de tâches déployée sur celui-ci en mode débogage.

  3. Créez un déploiement de débogage. Les paramètres de déploiement sont les mêmes qu’un déploiement de séquence de tâches normal. Pour plus d’informations, consultez Déployer une séquence de tâches.

    Remarque

    Vous ne pouvez sélectionner qu’un petit regroupement pour un déploiement de débogage. Il affiche uniquement les regroupements d’appareils avec 10 membres ou moins.

Utilisez la variable de séquence de tâches TSDebugOnError pour démarrer automatiquement le débogueur lorsque la séquence de tâches retourne une erreur. Pour plus d’informations, consultez Variables de séquence de tâches - TSDebugOnError.

Utiliser l’outil

Lorsque la séquence de tâches s’exécute sur l’appareil, la fenêtre Débogueur de séquence de tâches s’ouvre comme dans la capture d’écran suivante :

Capture d’écran du débogueur de séquence de tâches.

Le débogueur comprend les contrôles suivants :

  • Étape : à partir de la position actuelle , exécutez uniquement l’étape suivante dans la séquence de tâches.

    Remarque

    Lorsque la séquence de tâches est en mode débogage, si une étape retourne une erreur irrécupérable, la séquence de tâches n’échoue pas normalement. Ce comportement vous donne la possibilité de réessayer une étape après avoir apporté une modification externe.

  • Exécuter : à partir de la position actuelle , exécutez la séquence de tâches normalement jusqu’à la fin, le point d’arrêt suivant ou en cas d’échec d’une étape. Avant d’utiliser cette action, veillez à définir les points d’arrêt avec l’action Définir l’arrêt .

  • Définir actuel : sélectionnez une étape dans le débogueur, puis sélectionnez Définir actuel. Cette action déplace le pointeur actuel vers cette étape. Cette action vous permet d’ignorer les étapes ou de reculer.

    Avertissement

    Le débogueur ne tient pas compte du type d’étape lorsque vous modifiez la position actuelle dans la séquence. Certaines étapes peuvent définir des variables de séquence de tâches requises pour l’évaluation des conditions par des étapes ultérieures. En cas de panne, certaines étapes peuvent échouer ou causer des dommages importants à un appareil. Utilisez cette option à vos propres risques.

  • Définir l’arrêt : sélectionnez une étape dans le débogueur, puis sélectionnez Définir l’arrêt. Cette action ajoute un point d’arrêt dans le débogueur. Lorsque vous exécutez la séquence de tâches, elle s’arrête à un arrêt.

    • Avant d’utiliser l’action Exécuter, définissez des points d’arrêt.

    • Si vous créez un point d’arrêt dans le débogueur, puis que la séquence de tâches redémarre l’ordinateur, le débogueur conserve vos points d’arrêt après le redémarrage.

  • Effacer tous les sauts : supprimez tous les points d’arrêt.

  • Fichier journal : ouvre le fichier journal de séquence de tâches actuel, smsts.log, avec CMTrace. Vous pouvez voir les entrées de journal lorsque le moteur de séquence de tâches est « En attente du débogueur ».

  • Invite de commandes : dans Windows PE, ouvre une invite de commandes.

  • Annuler : fermez le débogueur et faites échouer la séquence de tâches.

  • Quitter : détachez et fermez le débogueur, mais la séquence de tâches continue de s’exécuter normalement.

La fenêtre Variables de séquence de tâches affiche les valeurs actuelles de toutes les variables dans l’environnement de séquence de tâches. Pour plus d’informations, consultez Variables de séquence de tâches. Si vous utilisez l’étape Définir la variable de séquence de tâches avec l’option Ne pas afficher cette valeur, le débogueur n’affiche pas la valeur de la variable. Vous ne pouvez pas modifier les valeurs des variables dans le débogueur.

Remarque

Certaines variables de séquence de tâches sont destinées à un usage interne uniquement et ne sont pas répertoriées dans la documentation de référence.

Le débogueur de séquence de tâches continue à s’exécuter après une étape Redémarrer l’ordinateur . Le débogueur conserve vos points d’arrêt après le redémarrage. Même si la séquence de tâches peut ne pas l’exiger, étant donné que le débogueur nécessite une interaction de l’utilisateur, vous devez vous connecter à Windows pour continuer. Si vous ne vous connectez pas après une heure pour poursuivre le débogage, la séquence de tâches échoue.

Il effectue également un pas à pas dans une séquence de tâches enfant avec l’étape Exécuter la séquence de tâches . La fenêtre du débogueur affiche les étapes de la séquence de tâches enfant ainsi que la séquence de tâches principale.

Problèmes connus

Si vous ciblez à la fois un déploiement normal et un déploiement de débogage sur le même appareil via plusieurs déploiements, le débogueur de séquence de tâches peut ne pas se lancer.

Voir aussi