Vous pouvez définir trois types de points d'arrêt dans l'environnement de débogage Windows PowerShell : des points d'arrêt de variable, des points d'arrêt de commande et des points d'arrêt de ligne. Parmi ceux-ci, dans l'environnement de débogage Windows PowerShell ISE, seuls les points d'arrêt de ligne sont mis en surbrillance et peuvent être définis à l'aide du menu ou des raccourcis clavier. Les deux autres types de points d'arrêt peuvent également être définis, mais ils le sont à partir du volet de commandes à l'aide de l'applet de commande Set-PSBreakpoint. Vous pouvez supprimer, activer, désactiver et lister tous les points d'arrêt. Cette section vous explique comment effectuer des tâches de débogage dans Windows PowerShell ISE à l'aide des menus lorsqu'ils sont disponibles et comment exécuter une plus vaste gamme de commandes à partir du volet de commandes à l'aide de scripts.

Gestion des points d'arrêt

Définir un point d'arrêt

Définit un point d'arrêt de ligne dans un script ou une fonction Windows PowerShell. Un point d'arrêt ne peut être défini dans un script qu'après son enregistrement.

Cliquez avec le bouton droit sur la ligne où vous souhaitez définir un point d'arrêt, puis cliquez sur Activer/désactiver le point d'arrêt. Sinon, cliquez sur la ligne où vous souhaitez définir un point d'arrêt et, dans le menu Déboguer, cliquez sur Activer/désactiver le point d'arrêt. L'exemple de script suivant vous montre comment définir un point d'arrêt de variable à partir du volet de commandes à l'aide de l'applet de commande Set-PSBreakpoint.

# This command sets a breakpoint on the Server variable in the Sample.ps1 script.
set-psbreakpoint -script sample.ps1 -variable Server 

Lister tous les points d'arrêt

Affiche tous les points d'arrêt de la session active.

Dans le menu Déboguer, cliquez sur Lister les points d'arrêt. L'exemple de script suivant vous montre comment répertorier tous les points d'arrêt à partir du volet de commandes à l'aide de l'applet de commande Get-PSBreakpoint.

 # This command lists all breakpoints in the current session. 
get-psbreakpoint 

Supprimer un point d'arrêt

Supprime un point d'arrêt de ligne spécifique.

Cliquez avec le bouton droit sur la ligne où vous souhaitez supprimer un point d'arrêt, puis cliquez sur Activer/désactiver le point d'arrêt. Sinon, cliquez sur la ligne où vous souhaitez supprimer un point d'arrêt et, dans le menu Déboguer, cliquez sur Activer/désactiver le point d'arrêt. L'exemple de script suivant vous montre comment supprimer un point d'arrêt ayant un ID spécifié à partir du volet de commandes à l'aide de l'applet de commande Remove-PSBreakpoint.

# This command deletes the breakpoint with breakpoint ID 2.
remove-psbreakpoint -id 2

Supprimer tous les points d'arrêt

Supprime tous les points d'arrêt de la session active.

Dans le menu Déboguer, cliquez sur Supprimer tous les points d'arrêt. L'exemple de script suivant vous montre comment supprimer tous les points d'arrêt à partir du volet de commandes à l'aide de l'applet de commande Remove-PSBreakpoint.

# This command deletes all of the breakpoints in the current session.
get-breakpoint | remove-breakpoint


Désactiver un point d'arrêt

Désactive un point d'arrêt de ligne spécifique.

Cliquez avec le bouton droit sur la ligne où vous souhaitez désactiver un point d'arrêt, puis cliquez sur Désactiver le point d'arrêt. Sinon, cliquez sur la ligne où vous souhaitez désactiver un point d'arrêt et, dans le menu Déboguer, cliquez sur Désactiver le point d'arrêt. L'exemple de script suivant vous montre comment désactiver un point d'arrêt ayant un ID spécifié à partir du volet de commandes à l'aide de l'applet de commande Disable-PSBreakpoint.

# This command disables the breakpoint with breakpoint ID 0.
disable-psbreakpoint -id 0


Désactiver tous les points d'arrêt

Désactive tous les points d'arrêt dans la session active.

Dans le menu Déboguer, cliquez sur Désactiver tous les points d'arrêt. L'exemple de script suivant vous montre comment désactiver tous les points d'arrêt à partir du volet de commandes à l'aide de l'applet de commande Disable-PSBreakpoint.

# This command disables all breakpoints in the current console. 
# You can abbreviate this command as: "gbp | dbp".

get-psbreakpoint | disable-psbreakpoint




Activer un point d'arrêt

Active un point d'arrêt de ligne spécifique.

Cliquez avec le bouton droit sur la ligne où vous souhaitez activer un point d'arrêt, puis cliquez sur Activer le point d'arrêt. Sinon, cliquez sur la ligne où vous souhaitez activer un point d'arrêt, puis appuyez sur F8 ou, dans le menu Déboguer, cliquez sur Activer le point d'arrêt. L'exemple de script suivant vous montre comment activer des points d'arrêt spécifiques à partir du volet de commandes à l'aide de l'applet de commande Enable-PSBreakpoint.

# This command enables breakpoints with breakpoint IDs 0, 1, and 5.
enable-psbreakpoint -id 0, 1, 5




Activer tous les points d'arrêt

Active tous les points d'arrêt dans la session active.

Dans le menu Déboguer, cliquez sur Activer tous les points d'arrêt. L'exemple de script suivant vous montre comment activer tous les points d'arrêt à partir du volet de commandes à l'aide de l'applet de commande Enable-PSBreakpoint.

# This command enables all breakpoints in the current session. 
# You can abbreviate the command as "gbp | ebp".


get-psbreakpoint | enable-psbreakpoint

Voir aussi




Table des matières