Write-Debug
É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
Concepts
Write-Verbose
Write-Error
Write-Host
Write-Progress
Write-Output
Write-Warning