Write-Debug
Schreibt eine Debugmeldung in die Konsole.
Syntax
Default (Standardwert)
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 $DebugPreference finden 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 Continue
$DebugPreference is Continue
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.
Weitere Informationen zum Debug- allgemeinen Parameter finden Sie unter about_CommonParameters.
Parameter
-Message
Gibt die Debugnachricht an, die an die Konsole gesendet werden soll.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Msg |
Parametersätze
(All)
| Position: | 0 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.
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.
