Freigeben über

Write-Debug

  • Referenz
Modul:
Microsoft.PowerShell.Utility

Schreibt eine Debugmeldung in die Konsole.

Syntax

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

Beschreibung

Das cmdlet Write-Debug 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 Debug--Parameters oder der $DebugPreference Variablen angezeigt werden.

Beispiele

Beispiel 1: Grundlegendes zu $DebugPreference

In diesem Beispiel wird eine Debugnachricht geschrieben.

Write-Debug "Cannot open file."

Der Standardwert von $DebugPreference ist SilentlyContinue. Daher wird die Nachricht nicht in der Konsole angezeigt.

Beispiel 2: Ändern des Werts von $DebugPreference

In diesem Beispiel wird die Auswirkung der Änderung des Werts der variablen $DebugPreference veranschaulicht. Zunächst wird der aktuelle Wert von $DebugPreference angezeigt und versucht, eine Debugmeldung zu schreiben. Anschließend ändern wir den Wert von $DebugPreference in Continue, wodurch 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 Debugdatenstrom. In diesem Beispiel verwenden wir den parameter Debug, um den wert $DebugPreference 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 Inquire

Confirm
Continue with this operation?
[Y] Yes  [A] Yes to All  [H] Halt Command  [?] Help (default is "Y"):
$DebugPreference is Inquire
PS> $DebugPreference
SilentlyContinue

Beachten Sie, dass sich der Wert $DebugPreference ändert, wenn Sie den Parameter Debug verwenden. Diese Änderung wirkt sich nur auf den Bereich der Funktion aus. Der Wert ist außerhalb der Funktion nicht betroffen.

Anmerkung

Wenn der Wert von $DebugPreferenceInquireist, hält PowerShell die Ausführung an, um zu fragen, ob die Ausführung fortgesetzt werden soll.

Weitere Informationen zum Debug- allgemeinen Parameter finden Sie unter about_CommonParameters.

Parameter

-Message

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

Typ:String
Aliase:Msg
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Eingaben

String

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

Ausgaben

None

Dieses Cmdlet gibt keine Ausgabe zurück. Er schreibt nur in den Debugdatenstrom.