Écrit un message de débogage sur la console.

Syntaxe

Write-Debug [-Message] <string> [<CommonParameters>]

Description

L'applet de commande Write-Debug écrit des messages de débogage sur la console à partir d'un script ou d'une commande.

Par défaut, les messages de débogage ne sont pas affichés dans la console, mais vous pouvez les consulter par l'intermédiaire du paramètre Debug ou de la variable $DebugPreference.

Paramètres

-Message <string>

Spécifie le message de débogage à envoyer à la console.

Obligatoire ?

true

Position ?

1

Valeur par défaut

Accepter l'entrée de pipeline ?

true (ByValue)

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

System.String

Vous pouvez diriger une chaîne contenant un message de débogage vers Write-Debug.

Sorties

Aucun

Write-Debug écrit uniquement dans le flux de débogage. Il ne retourne aucune sortie.

Exemple 1

C:\PS>Write-Debug "Cannot open file."

Description
-----------
Cette commande écrit un message de débogage. Étant donné que la valeur de $DebugPreference est « SilentlyContinue », le message ne s'affiche pas dans la console.






Exemple 2

C:\PS>$DebugPreference

SilentlyContinue

C:\PS> Write-Debug "Cannot open file."
C:\PS>

C:\PS> Write-Debug "Cannot open file." -debug
DEBUG: Cannot open file.

Description
-----------
Cet exemple montre comment utiliser le paramètre courant Debug pour remplacer la valeur de la variable $DebugPreference d'une commande spécifique. 

La première commande affiche la valeur de la variable $DebugPreference, à savoir « SilentlyContinue », qui est la valeur par défaut.

La deuxième commande écrit un message de débogage mais, à cause de la valeur de $DebugPreference, le message n'apparaît pas. 

La troisième commande écrit un message de débogage. Elle utilise le paramètre courant Debug pour remplacer la valeur de $DebugPreference et afficher les messages de débogage qui résultent de cette commande.

Par conséquent, bien que la valeur de $DebugPreference soit « SilentlyContinue », le message de débogage apparaît.


Pour plus d'informations sur le paramètre courant Debug, consultez about_CommonParameters.






Exemple 3

C:\PS>$DebugPreference

SilentlyContinue

C:\PS> Write-Debug "Cannot open file."
C:\PS>

C:\PS> $DebugPreference = "Continue"

C:\PS> Write-Debug "Cannot open file."
DEBUG: Cannot open file.

Description
-----------
Cette commande illustre le résultat de la modification de la valeur de la variable $DebugPreference sur l'affichage des messages de débogage.

La première commande affiche la valeur de la variable $DebugPreference, à savoir « SilentlyContinue », qui est la valeur par défaut.

La deuxième commande écrit un message de débogage mais, à cause de la valeur de $DebugPreference, le message n'apparaît pas. 

La troisième commande attribue la valeur « Continue » à la variable $DebugPreference.

La quatrième commande écrit un message de débogage, qui apparaît sur la console.

Pour plus d'informations sur $DebugPreference, consultez about_Preference_Variables.






Voir aussi




Table des matières