Write-Debug

Schreibt eine Debugmeldung in die Konsole.

Syntax

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

Beschreibung

Das Cmdlet "Write-Debug" schreibt Debugmeldungen aus einem Skript oder Befehl in die Konsole.

Standardmäßig werden Debugmeldungen nicht in der Konsole angezeigt, jedoch können Sie sie mit dem Debug-Parameter oder der Variablen "$DebugPreference" anzeigen.

Parameter

-Message <string>

Gibt die Debugmeldung an, die an die Konsole gesendet werden soll.

Erforderlich?

true

Position?

1

Standardwert

Pipelineeingaben akzeptieren?

true (ByValue)

Platzhalterzeichen akzeptieren?

false

<CommonParameters>

Dieses Cmdlet unterstützt die folgenden allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_Commonparameters.

Eingaben und Ausgaben

Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können. Der Rückgabetyp ist der Typ der Objekte, die das Cmdlet zurückgibt.

Eingaben

System.String

Sie können über die Pipeline eine Zeichenfolge, die eine Debugmeldung enthält, an Write-Debug übergeben.

Ausgaben

Keiner

Write-Debug schreibt nur in den Debugstream. Es wird keine Ausgabe zurückgegeben.

Beispiel 1

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

Beschreibung
-----------
Dieser Befehl schreibt eine Debugmeldung. Da der Wert von $DebugPreference "SilentlyContinue" ist, wird die Meldung nicht in der Konsole angezeigt.





Beispiel 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.

Beschreibung
-----------
In diesem Beispiel wird gezeigt, wie der allgemeine Debug-Parameter verwendet wird, um den Wert der Variablen "$DebugPreference" für einen bestimmten Befehl zu überschreiben. 

Im ersten Befehl wird der Wert der Variablen "$DebugPreference", der "SilentlyContinue" lautet (der Standardwert), angezeigt.

Im zweiten Befehl wird eine Debugmeldung geschrieben, jedoch wird die Meldung aufgrund des Werts von $DebugPreference nicht angezeigt. 

Im dritten Befehl wird eine Debugmeldung geschrieben. Der allgemeine Debug-Parameter wird verwendet, um den Wert von $DebugPreference zu überschreiben und die Debugmeldungen anzuzeigen, die durch diesen Befehl verursacht werden.

Daher wird die Debugmeldung angezeigt, obwohl der Wert von $DebugPreference "SilentlyContinue" ist.


Weitere Informationen über den allgemeinen Debug-Parameter finden Sie unter "about_CommonParameters".





Beispiel 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.

Beschreibung
-----------
Dieser Befehl veranschaulicht die Auswirkungen, wenn der Wert der Variablen "$DebugPreference" für die Anzeige von Debugmeldungen geändert wird.

Im ersten Befehl wird der Wert der Variablen "$DebugPreference", der "SilentlyContinue" lautet (der Standardwert), angezeigt.

Im zweiten Befehl wird eine Debugmeldung geschrieben, jedoch wird die Meldung aufgrund des Werts von $DebugPreference nicht angezeigt. 

Im dritten Befehl wird der Variablen "$DebugPreference" der Wert "Continue" zugewiesen.

Im vierten Befehl wird eine Debugmeldung geschrieben, die in der Konsole angezeigt wird.

Weitere Informationen zu "$DebugPreference" finden Sie unter "about_Preference_Variables".





Siehe auch

Konzepte

Write-Verbose
Write-Error
Write-Host
Write-Progress
Write-Output
Write-Warning