Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
S’applique à : Configuration Manager (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 le dépannage 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.
Configuration requise
Mettez à 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 ne s’exécute que 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
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.
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 TSDebugMode sur
TRUEune collection ou un objet ordinateur sur lequel la séquence de tâches est déployée. Tout appareil qui a cette variable définie placera toute séquence de tâches déployée en mode débogage.Créez un déploiement de débogage. Les paramètres de déploiement sont identiques à ceux d’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’une petite collection pour un déploiement de débogage. Il affiche uniquement les regroupements d’appareils comptant 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 renvoie une erreur. Pour plus d’informations, voir 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 du débogueur de séquence de tâches s’ouvre, comme dans la capture d’écran suivante :
Le débogueur inclut les contrôles suivants :
Étape : À partir de la position actuelle , exécuter 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 renvoie 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 effectué 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 la rupture .
Définir actuel : sélectionnez une étape dans le débogueur, puis sélectionnez Définir actuel. Cette action déplace le pointeur actif vers cette étape. Cette action vous permet d’ignorer des étapes ou de reculer.
Avertissement
Le débogueur ne prend pas en compte le 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. Vous assumez l’ensemble des risques liés à cette option.
Set Break : Sélectionnez une étape dans le débogueur, puis sélectionnez Set Break. 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 à une pause.
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 toutes les pauses : 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, voir 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 de s’exécuter après une étape de redémarrage de 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 ne l’exige pas, étant donné que le débogueur nécessite l’interaction de l’utilisateur, vous devez vous connecter à Windows pour continuer. Si vous ne vous connectez pas au bout d’une heure pour continuer le débogage, la séquence de tâches échoue.
Il intervient également dans une séquence de tâches enfant à l’aide de 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 au travers de plusieurs déploiements, le débogueur de séquence de tâches peut ne pas se lancer.