Utilisez les informations suivantes pour déboguer un script en l'exécutant pas à pas.
Le processus d'exécution pas à pas consiste à exécuter une instruction à la fois. Vous pouvez vous arrêter sur une ligne de code et examiner les valeurs des variables et l'état du système. Le tableau suivant décrit les tâches de débogage courantes, telles que Pas à pas principal, Pas à pas détaillé et Pas à pas sortant.
|
Tâche de débogage |
Description |
Mode d'exécution dans PowerShell ISE |
|
Pas à pas détaillé |
Exécute l'instruction actuelle puis s'arrête à l'instruction suivante. Si l'instruction actuelle est un appel de fonction ou de script, le débogueur passe à cette fonction ou ce script, sinon, il s'arrête à l'instruction suivante. |
Dans le volet de commandes, tapez S et appuyez sur ENTRÉE ou, dans le menu Déboguer, cliquez sur Pas à pas détaillé. |
|
Pas à pas principal |
Exécute l'instruction actuelle puis s'arrête à l'instruction suivante. Si l'instruction actuelle est un appel de fonction ou de script, le débogueur exécute la fonction ou le script complet, puis il s'arrête à l'instruction suivante après l'appel de fonction. |
Dans le volet de commandes, tapez V et appuyez sur ENTRÉE ou, dans le menu Déboguer, cliquez sur Pas à pas principal. |
|
Pas à pas sortant |
Sort de la fonction actuelle en remontant d'un niveau si elle est imbriquée. S'il se trouve dans le corps principal, le script est exécuté jusqu'à la fin ou jusqu'au point d'arrêt suivant. Les instructions ignorées sont exécutées, mais pas en mode pas à pas. |
Dans le volet de commandes, tapez O et appuyez sur ENTRÉE ou, dans le menu Déboguer, cliquez sur Pas à pas sortant. |
|
Continuer |
Poursuit l'exécution jusqu'à la fin ou jusqu'au point d'arrêt suivant. Les fonctions et appels ignorés sont exécutés, mais pas en mode pas à pas. |
Dans le volet de commandes, tapez C et appuyez sur ENTRÉE ou, dans le menu Déboguer, cliquez sur Exécuter/Continuer. |
Débogage d'un script
- Définissez des points d'arrêt dans le code que vous souhaitez examiner. Pour plus d'informations sur la définition de points d'arrêt, consultez la rubrique How to Set, Remove, Disable Enable, Disable, and List Breakpoints ou la rubrique Set-PSBreakpoint.
-
Dans le menu Déboguer, cliquez sur Exécuter/Continuer ou, dans la barre d'outils, cliquez sur Exécuter le script. Voici ce à quoi vous pouvez vous attendre :
- Le débogage commence. Le script s'exécute jusqu'à ce qu'il localise le premier point d'arrêt, puis il s'arrête. Le point d'arrêt est mis en surbrillance.
- L'invite de commandes change et le préfixe [DBG] s'affiche dans la barre du volet de commandes.
- Un message signalant qu'un point d'arrêt a été rencontré s'affiche dans le volet de sortie. Par exemple, « Point d'arrêt de ligne sur C:\Users\name\Desktop\test.script.ps1:13 ».
- Le débogage commence. Le script s'exécute jusqu'à ce qu'il localise le premier point d'arrêt, puis il s'arrête. Le point d'arrêt est mis en surbrillance.
- À partir de ce stade, vous pouvez choisir le mode Pas à pas principal, Pas à pas détaillé, Pas à pas sortant ou Continuer. Avec l'option Continuer, le débogueur exécute le script jusqu'à la fin ou jusqu'au point d'arrêt suivant.
- Pour rechercher la valeur d'une variable pendant que vous effectuez le débogage, placez le curseur au-dessus de la variable dans le volet de script ou tapez le nom de la variable dans le volet de commandes, puis appuyez sur ENTRÉE. Le volet de sortie affiche la valeur de la variable. Continuez le débogage pas à pas du script ou effectuez d'autres tâches de débogage.
Voir aussi