Partager via

Write-Debug

Module:
Microsoft.PowerShell.Utility Module

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

Syntaxe

Default (Par défaut) 

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

Description

L’applet de commande Write-Debug écrit des messages de débogage sur l’hôte à 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 afficher à l’aide du paramètre de débogage ou de la variable .

Exemples

Exemple 1 : Comprendre $DebugPreference

Cet exemple écrit un message de débogage.

Write-Debug "Cannot open file."

La valeur par défaut de $DebugPreference est silentlyContinue. Par conséquent, le message n’est pas affiché dans la console.

Exemple 2 : Modifier la valeur de $DebugPreference

Cet exemple montre l’effet de la modification de la valeur de la variable $DebugPreference. Tout d’abord, nous affichons la valeur actuelle de $DebugPreference et essayons d’écrire un message de débogage. Ensuite, nous changeons la valeur de $DebugPreference en Continuer, ce qui permet d’afficher les messages de débogage.

PS> $DebugPreference
SilentlyContinue
PS> Write-Debug "Cannot open file."
PS>
PS> $DebugPreference = "Continue"
PS> Write-Debug "Cannot open file."
DEBUG: Cannot open file.

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

Exemple 3 : Utiliser le paramètre Debug pour remplacer $DebugPreference

La fonction Test-Debug écrit la valeur de la variable $DebugPreference sur l’hôte PowerShell et dans le flux de débogage. Dans cet exemple, nous utilisons le paramètre de débogage pour remplacer la valeur $DebugPreference.

function Test-Debug {
    [CmdletBinding()]
    param()
    Write-Debug ('$DebugPreference is ' + $DebugPreference)
    Write-Host ('$DebugPreference is ' + $DebugPreference)
}

PS> Test-Debug
$DebugPreference is SilentlyContinue

PS> Test-Debug -Debug
DEBUG: $DebugPreference is Continue
$DebugPreference is Continue
PS> $DebugPreference
SilentlyContinue

Notez que la valeur de change lorsque vous utilisez le paramètre de débogage . Cette modification affecte uniquement l’étendue de la fonction. La valeur n’est pas affectée en dehors de la fonction.

Pour plus d’informations sur le paramètre commun de débogage , consultez about_CommonParameters.

Paramètres

-Message

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Msg

Jeux de paramètres

(All)
Position:0
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

String

Vous pouvez diriger une chaîne contenant un message de débogage vers cette applet de commande.

Sorties

None

Cette applet de commande ne retourne aucune sortie. Il écrit uniquement dans le flux de débogage.