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.