Déboguer une séquence de tâchesDebug a task sequence

À partir de la version 1906, le débogueur de la séquence de tâches est un nouvel outil de dépannage.Starting in version 1906, the task sequence debugger is a new troubleshooting tool. Vous déployez une séquence de tâches en mode débogage vers une petite collection.You deploy a task sequence in debug mode to a small collection. Il vous permet de parcourir la séquence de tâches de manière contrôlée afin de faciliter la résolution des problèmes et l’examen.It lets you step through the task sequence in a controlled manner to aid troubleshooting and 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.The debugger currently runs on the same device as the task sequence engine, it's not a remote debugger.

Notes

Dans cette version de Configuration Manager, le débogueur de séquence de tâches est une fonctionnalité en préversion.In this version of Configuration Manager, the task sequence debugger is a pre-release feature. Pour l’activer, consultez Fonctionnalités de préversion.To enable it, see Pre-release features.

PrérequisPrerequisites

  • Mettre à jour le client Configuration Manager sur l’appareil cibleUpdate the Configuration Manager client on the target device

  • Connectez-vous à l’appareil cible en tant qu’utilisateur dans le groupe administrateurs local.Sign in to the target device as a user in the local Administrators group. Le débogueur s’exécute uniquement pour les administrateurs.The debugger only runs for administrators.

  • Mettre à jour l’image de démarrage associée à la séquence de tâches pour garantir qu’elle dispose de la dernière version du clientUpdate the boot image associated with the task sequence to make sure it has the latest client version

Démarrer l’outilStart the tool

  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.In the Configuration Manager console, go to the Software Library workspace, expand Operating Systems, and select Task Sequences.

  2. Sélectionnez une séquence de tâches.Select a task sequence. Dans le groupe Déploiement du ruban, sélectionnez Déboguer.In the Deployment group of the ribbon, select Debug.

    Conseil

    Vous pouvez également définir la variable TSDebugMode avec la valeur TRUE sur un regroupement ou un objet ordinateur sur lequel la séquence de tâches est déployée.Alternatively, set the variable TSDebugMode to TRUE on a collection or computer object to which the task sequence is deployed. Tout appareil sur lequel cette variable est définie placera toute séquence de tâches déployée en mode débogage.Any device that has this variable set will put any task sequence deployed to it into debug mode.

  3. Créez un déploiement de débogage.Create a debug deployment. Les paramètres de déploiement sont les mêmes que ceux d’un déploiement de séquence de tâches normal.The deployment settings are the same as a normal task sequence deployment. Pour plus d'informations, voir Déployer une séquence de tâches.For more information, see Deploy a task sequence.

    Notes

    Vous ne pouvez sélectionner qu’une petite collection pour un déploiement de débogage.You can only select a small collection for a debug deployment. Il affiche uniquement les regroupements de périphériques avec 10 membres ou moins.It only displays device collections with 10 or less members.

Utiliser l’outilUse the tool

Quand la séquence de tâches s’exécute sur l’appareil, la fenêtre Débogueur de séquences de tâches, semblable à la capture d’écran suivante, s’ouvre :When the task sequence runs on the device, the Task Sequence Debugger window opens similar to the following screenshot:

Capture d’écran de la fenêtre Débogueur de séquences de tâches

Le débogueur inclut les contrôles suivants :The debugger includes the following controls:

  • Étape : à partir de la position actuelle, exécutez uniquement l’étape suivante de la séquence de tâches.Step: From the current position, run only the next step in the task sequence.

    Notes

    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 ne réussit pas à fonctionner normalement.When the task sequence is in debug mode, if a step returns a fatal error, the task sequence doesn't fail as normal. Ce comportement vous donne la possibilité de réessayer une étape une fois que vous avez apporté une modification externe.This behavior gives you the option to retry a step after you make an external change.

  • Exécuter : à partir de la position actuelle, exécutez la séquence de tâches normalement jusqu’à la fin ou jusqu’au prochain point d’arrêt ou si une étape échoue.Run: From the current position, run the task sequence normally to the end, the next break point, or if a step fails. Avant d’utiliser cette action, veillez à définir des points d’arrêt à l’aide de l’action définir une interruption .Before you use this action, make sure to set any break points with the Set Break action.

  • Définir la position actuelle : sélectionnez une étape dans le débogueur, puis sélectionnez Définir la position actuelle.Set Current: Select a step in the debugger and then select Set Current. Cette action déplace le pointeur actuel à l’étape concernée.This action moves the current pointer to that step. Cette action vous permet d’ignorer des étapes ou de reculer.This action allows you to skip steps or move backwards.

    Avertissement

    Le débogueur ne prend pas en considération le type d’étape quand vous changez la position actuelle dans la séquence.The debugger doesn't consider the type of step when you change the current position in the sequence. Certaines étapes peuvent définir des variables de séquence de tâches qui sont requises pour l’évaluation de condition dans les étapes ultérieures.Some steps may set task sequence variables that are required for condition evaluation by later steps. Certaines étapes peuvent échouer ou provoquer d’importants dommages à un appareil si elles sont exécutées dans le désordre.If run out of order, some steps may fail or cause significant damage to a device. Vous utilisez cette option à vos risques et périls.Use this option at your own risk.

  • Définir un arrêt : sélectionnez une étape dans le débogueur, puis sélectionnez Définir un arrêt.Set Break: Select a step in the debugger and then select Set Break. Cette action ajoute un point d’arrêt dans le débogueur.This action adds a break point in the debugger. Quand vous exécutez la séquence de tâches, il s’arrête à un arrêt.When you Run the task sequence, it stops at a break.

    • Avant d’utiliser l’action d' exécution , définissez des points d’arrêt.Before you use the Run action, set break points.

    • Les points d’arrêt ne sont pas enregistrés après le redémarrage de l’ordinateur, comme avec l’étape redémarrer l’ordinateur .Break points aren't saved after the computer restarts, like with the Restart Computer step. Par exemple, si vous démarrez le débogueur à partir du centre logiciel pour une séquence de tâches de création d’images, ne définissez pas de sauts dans la phase Windows PE.For example, if you start the debugger from Software Center for an imaging task sequence, don't set breaks in the Windows PE phase. Lorsque l’ordinateur redémarre dans Windows PE, le débogueur interrompt la séquence de tâches afin que vous puissiez définir des arrêts.When the computer restarts into Windows PE, the debugger pauses the task sequence so that you can set breaks.

  • Effacer tous les arrêts: supprime tous les points d’arrêt.Clear All Breaks: Remove all break points.

  • Fichier journal: ouvre le fichier journal de la séquence de tâches en cours, fichier smsts. log, avec CMTrace.Log File: Opens the current task sequence log file, smsts.log, with CMTrace. Vous pouvez voir les entrées de journal lorsque le moteur de séquence de tâches est en attente d’attente du débogueur.You can see log entries when the task sequence engine is "Waiting for the debugger."

  • Invite cmd: dans Windows PE, ouvre une invite de commandes.Cmd Prompt: In Windows PE, opens a command prompt.

  • Annuler: fermer le débogueur et faire échouer la séquence de tâches.Cancel: Close the debugger, and fail the task sequence.

  • Quitter: détacher et fermer le débogueur, mais la séquence de tâches continue de s’exécuter normalement.Quit: Detach and close the debugger, but the task sequence continues to run normally.

La fenêtre variables de séquence de tâches affiche les valeurs actuelles de toutes les variables dans l’environnement de la séquence de tâches.The Task Sequence Variables window shows the current values for all variables in the task sequence environment. Pour plus d’informations, voir Variables de séquence de tâches.For more information, see Task sequence variables. 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.If you use the Set Task Sequence Variable step with the option to Do not display this value, the debugger doesn't display the variable value. Vous ne pouvez pas modifier les valeurs des variables dans le débogueur.You can't edit the variable values in the debugger.

Notes

Certaines variables de séquence de tâches sont réservées à un usage interne et ne sont pas répertoriées dans la documentation de référence.Some task sequence variables are for internal use only, and not listed in the reference documentation.

Le débogueur de séquence de tâches continue à s’exécuter après une étape redémarrer l’ordinateur , mais vous devez recréer tous les points d’arrêt.The task sequence debugger continues to run after a Restart Computer step, but you need to recreate any break points. Même si la séquence de tâches peut ne pas en avoir besoin, étant donné que le débogueur nécessite une intervention de l’utilisateur, vous devez vous connecter à Windows pour continuer.Even though the task sequence may not require it, since the debugger requires user interaction, you need to sign in to Windows to continue. Si vous ne vous connectez pas après une heure pour continuer le débogage, la séquence de tâches échoue.If you don't sign in after one hour to continue debugging, the task sequence fails.

Il passe également à une séquence de tâches enfant avec l’étape exécuter la séquence de tâches .It also steps into a child task sequence with the Run Task Sequence step. La fenêtre du débogueur affiche les étapes de la séquence de tâches enfant avec la séquence de tâches principale.The debugger window shows the steps of the child task sequence along with the main task sequence.

Problèmes connusKnown issues

Si vous ciblez un déploiement normal et un déploiement de débogage sur le même appareil à l’aide de plusieurs déploiements, le débogueur de séquence de tâches peut ne pas démarrer.If you target both a normal deployment and debug deployment to the same device through multiple deployments, the task sequence debugger may not launch.

Voir aussiSee also