Write-Debug
Schreibt eine Debugmeldung in die Konsole.
Syntax
Write-Debug
[-Message] <String>
[<CommonParameters>]
Beschreibung
Das Write-Debug
Cmdlet schreibt Debugnachrichten aus einem Skript oder Befehl in den Host.
Standardmäßig werden Debugnachrichten nicht in der Konsole angezeigt, sie können jedoch mithilfe des Debugparameters oder der $DebugPreference
Variablen angezeigt werden.
Beispiele
Beispiel 1: Verstehen von $DebugPreference
In diesem Beispiel wird eine Debugnachricht geschrieben.
Write-Debug "Cannot open file."
Der Standardwert $DebugPreference
ist SilentlyContinue. Daher wird die Nachricht nicht in der Konsole angezeigt.
Beispiel 2: Ändern des Werts von $DebugPreference
In diesem Beispiel wird der Effekt des Änderns des Werts der $DebugPreference
Variable dargestellt. Zunächst wird der aktuelle Wert $DebugPreference
angezeigt und versucht, eine Debugnachricht zu schreiben. Anschließend ändern wir den Wert von $DebugPreference
" Weiter", mit dem Debugnachrichten angezeigt werden können.
PS> $DebugPreference
SilentlyContinue
PS> Write-Debug "Cannot open file."
PS>
PS> $DebugPreference = "Continue"
PS> Write-Debug "Cannot open file."
DEBUG: Cannot open file.
Weitere Informationen finden $DebugPreference
Sie unter about_Preference_Variables.
Beispiel 3: Verwenden des Debugparameters zum Außerkraftsetzen von $DebugPreference
Die Test-Debug
Funktion schreibt den Wert der $DebugPreference
Variable auf den PowerShell-Host und den Debugdatenstrom. In diesem Beispiel verwenden wir den Debugparameter , um den $DebugPreference
Wert außer Kraft zu setzen.
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
Beachten Sie, dass der Wert von $DebugPreference
Änderungen beim Verwenden des Debugparameters geändert wird. Diese Änderung wirkt sich nur auf den Umfang der Funktion aus. Der Wert ist außerhalb der Funktion nicht betroffen.
Weitere Informationen zum allgemeinen Debugparameter finden Sie unter about_CommonParameters.
Parameter
-Message
Gibt die Debugmeldung an, die an die Konsole gesendet werden soll.
Type: | String |
Aliases: | Msg |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Eingaben
Sie können eine Zeichenfolge senden, die eine Debugnachricht enthält Write-Debug
.
Ausgaben
None
Write-Debug
Schreibt nur in den Debugdatenstrom. Es schreibt keine Objekte in die Pipeline.