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 auf den Host.
Standardmäßig werden Debugmeldungen nicht in der Konsole angezeigt, sie können jedoch mithilfe des Debugparameters oder der $DebugPreference
Variablen angezeigt werden.
Beispiele
Beispiel 1: Grundlegendes zu $DebugPreference
In diesem Beispiel wird eine Debugmeldung geschrieben.
Write-Debug "Cannot open file."
Der Standardwert von $DebugPreference
ist SilentlyContinue. Daher wird die Meldung nicht in der Konsole angezeigt.
Beispiel 2: Ändern des Werts von $DebugPreference
In diesem Beispiel wird die Auswirkung der Änderung des Werts der $DebugPreference
Variablen veranschaulicht. Zunächst wird der aktuelle Wert von $DebugPreference
angezeigt und versucht, eine Debugmeldung zu schreiben. Anschließend ändern wir den Wert von in $DebugPreference
Weiter, sodass Debugmeldungen 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 zu $DebugPreference
finden Sie unter about_Preference_Variables.
Beispiel 3: Verwenden des Debugparameters zum Überschreiben $DebugPreference
Die Test-Debug
Funktion schreibt den Wert der $DebugPreference
Variablen in den PowerShell-Host und in den Debugstream. In diesem Beispiel verwenden wir den Debug-Parameter , um den $DebugPreference
Wert zu überschreiben.
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 sich der Wert von $DebugPreference
ändert, wenn Sie den Debug-Parameter verwenden. Diese Änderung wirkt sich nur auf den Bereich der Funktion aus. Der Wert ist außerhalb der Funktion nicht betroffen.
Weitere Informationen zum allgemeinen Debug-Parameter 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, die eine Debugmeldung enthält, an übergeben Write-Debug
.
Ausgaben
None
Write-Debug
schreibt nur in den Debugstream. Es schreibt keine Objekte in die Pipeline.