Share via

Write-Debug

  • Referenz
Modul:
Microsoft.PowerShell.Utility

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. Zuerst zeigen wir den aktuellen Wert von an $DebugPreference und versuchen, eine Debugmeldung zu schreiben. Anschließend ändern wir den Wert von $DebugPreference in 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 $DebugPreferencefinden Sie unter about_Preference_Variables.

Beispiel 3: Verwenden des Debugparameters zum Überschreiben von $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 wird außerhalb der Funktion nicht beeinflusst.

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

String

Sie können eine Zeichenfolge, die eine Debugmeldung enthält, an dieses Cmdlet übergeben.

Ausgaben

None

Dieses Cmdlet gibt keine Ausgabe zurück. Es wird nur in den Debugstream geschrieben.