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 in den Host.
Standardmäßig werden Debugnachrichten nicht in der Konsole angezeigt, sie können jedoch mithilfe des Debugparameters oder der $DebugPreference Variablen angezeigt werden.
Beispiele
Beispiel 1: Verstehen von $DebugPreference
In diesem Beispiel wird eine Debugnachricht geschrieben.
Write-Debug "Cannot open file."Der Standardwert $DebugPreference ist SilentlyContinue. Daher wird die Nachricht nicht in der Konsole angezeigt.
Beispiel 2: Ändern des Werts von $DebugPreference
In diesem Beispiel wird der Effekt des Änderns des Werts der $DebugPreference Variable dargestellt. Zunächst wird der aktuelle Wert $DebugPreference angezeigt und versucht, eine Debugnachricht zu schreiben. Anschließend ändern wir den Wert von $DebugPreference " Weiter", mit dem Debugnachrichten 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 finden $DebugPreferenceSie unter about_Preference_Variables.
Beispiel 3: Verwenden des Debugparameters zum Außerkraftsetzen von $DebugPreference
Die Test-Debug Funktion schreibt den Wert der $DebugPreference Variable auf den PowerShell-Host und den Debugdatenstrom. In diesem Beispiel verwenden wir den Debugparameter , 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
SilentlyContinueBeachten Sie, dass der Wert von $DebugPreference Änderungen beim Verwenden des Debugparameters geändert wird. Diese Änderung wirkt sich nur auf den Umfang 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
Sie können eine Zeichenfolge senden, die eine Debugnachricht enthält Write-Debug.
Ausgaben
None
Write-Debug Schreibt nur in den Debugdatenstrom. Es schreibt keine Objekte in die Pipeline.