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 Debugmeldungen aus einem Skript oder Befehl in 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 Debugnachricht geschrieben.

Write-Debug "Cannot open file."

Der Standardwert lautet $DebugPreference"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 $DebugPreference Variablen veranschaulicht. Zunächst zeigen wir den aktuellen Wert an $DebugPreference und versuchen, eine Debugmeldung zu schreiben. Anschließend ändern wir den Wert von $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 $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 Debug-Parameter , um den $DebugPreference Wert 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 Continue
$DebugPreference is Continue
PS> $DebugPreference
SilentlyContinue

Beachten Sie, dass der Wert von $DebugPreference Änderungen bei Verwendung des Debugparameters geändert wird. Diese Änderung wirkt sich nur auf den Bereich der Funktion aus. Der Wert ist außerhalb der Funktion nicht betroffen.

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

Ausgaben

None

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