Set-PSDebug
Active et désactive les fonctions de débogage de script, définit le niveau de trace et active/désactive le mode strict.
Syntaxe
Set-PSDebug [-Off] [<CommonParameters>]
Set-PSDebug [-Step] [-Strict] [-Trace <int>] [<CommonParameters>]
Description
L'applet de commande Set-PSDebug active et désactive les fonctions de débogage de script, définit le niveau de trace et active/désactive le mode strict.
Lorsque le paramètre Trace est défini sur 1, chaque ligne de script est tracée tout au long de son exécution. Lorsque le paramètre est défini sur 2, les affectations de variables, les appels de fonction et les appels de script sont également tracés. Si le paramètre Step est spécifié, une invite s'affiche avant l'exécution de chaque ligne du script.
Paramètres
-Off
Désactive toutes les fonctions de débogage du script.
Remarque : une commande « set-strictmode –off » désactive la vérification définie par une commande « set-psdebug –strict ». Pour plus d'informations, consultez Set-StrictMode.
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
|
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-Step
Active l'exécution par étape du script. Avant l'exécution de chaque ligne, l'utilisateur est invité à arrêter ou continuer l'exécution, ou bien à accéder à un nouveau niveau d'interpréteur pour inspecter l'état du script.
Remarque : la spécification du paramètre Step définit automatiquement le niveau de trace 1.
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
|
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-Strict
Spécifie que l'interpréteur doit lever une exception si une variable est référencée avant qu'une valeur lui soit assignée.
Remarque : une commande « set-strictmode –off » désactive la vérification définie par une commande « set-psdebug –strict ». Pour plus d'informations, consultez Set-StrictMode.
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
|
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-Trace <int>
Spécifie le niveau de trace :
0 - Désactive le traçage du script
1 - Trace les lignes de script lors de leur exécution
2 - Trace les lignes de script, les affectations de variables, les appels de fonction et les scripts.
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
|
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
<CommonParameters>
Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez about_Commonparameters.
Entrées et sorties
Le type d'entrée est le type des objets que vous pouvez diriger vers l'applet de commande. Le type de retour est le type des objets que l'applet de commande retourne.
Entrées |
Aucun Vous ne pouvez pas diriger d'entrée vers cette applet de commande. |
Sorties |
Aucun Cette applet de commande ne retourne aucune sortie. |
Exemple 1
C:\PS>set-psdebug -trace 2; foreach ($i in 1..3) {$i}
DEBUG: 1+ Set-PsDebug -trace 2; foreach ($i in 1..3) {$i}
DEBUG: 1+ Set-PsDebug -trace 2; foreach ($i in 1..3) {$i}
1
DEBUG: 1+ Set-PsDebug -trace 2; foreach ($i in 1..3) {$i}
2
DEBUG: 1+ Set-PsDebug -trace 2; foreach ($i in 1..3) {$i}
3
Description
-----------
Cette commande définit le niveau de trace sur 2, puis exécute un script qui affiche les nombres 1, 2 et 3.
Exemple 2
C:\PS>set-psdebug -step; foreach ($i in 1..3) {$i}
DEBUG: 1+ Set-PsDebug -step; foreach ($i in 1..3) {$i}
Continue with this operation?
1+ Set-PsDebug -step; foreach ($i in 1..3) {$i}
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help
(default is "Y"):a
DEBUG: 1+ Set-PsDebug -step; foreach ($i in 1..3) {$i}
1
2
3
Description
-----------
Cette commande active l'exécution par étape,
puis exécute un script qui affiche les nombres 1, 2 et 3.
Exemple 3
C:\PS>set-psdebug -off; foreach ($i in 1..3) {$i}
1
2
3
Description
-----------
Cette commande désactive toutes les fonctions de débogage, puis exécute un script qui affiche les nombres 1, 2 et 3.
Exemple 4
C:\PS>set-psdebug -strict; $NewVar
The variable $NewVar cannot be retrieved because it has not been set yet.
At line:1 char:28
+ Set-PsDebug -strict;$NewVar <<<<
Description
-----------
Cette commande met l'interpréteur en mode strict, puis essaie d'accéder à une variable qui n'a pas encore été définie.
Voir aussi
Concepts
about_Debuggers
Debug-Process
Set-PSBreakpoint
Set-StrictMode
Write-Debug