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 |
None 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