Udostępnij za pośrednictwem

Write-Debug

  • Odwołanie
Moduł:
Microsoft.PowerShell.Utility

Zapisuje komunikat debugowania w konsoli programu .

Składnia

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

Opis

Polecenie cmdlet Write-Debug zapisuje komunikaty debugowania na hoście za pomocą skryptu lub polecenia.

Domyślnie komunikaty debugowania nie są wyświetlane w konsoli programu , ale można je wyświetlić przy użyciu parametru Debug lub zmiennej $DebugPreference.

Przykłady

Przykład 1. Omówienie $DebugPreference

W tym przykładzie jest zapisywany komunikat debugowania.

Write-Debug "Cannot open file."

Wartość domyślna $DebugPreference to SilentlyContinue. W związku z tym komunikat nie jest wyświetlany w konsoli programu .

Przykład 2. Zmiana wartości $DebugPreference

W tym przykładzie pokazano efekt zmiany wartości zmiennej $DebugPreference. Najpierw wyświetlamy bieżącą wartość $DebugPreference i próbujemy napisać komunikat debugowania. Następnie zmieniamy wartość $DebugPreference na Kontynuuj, co umożliwia wyświetlanie komunikatów debugowania.

PS> $DebugPreference
SilentlyContinue
PS> Write-Debug "Cannot open file."
PS>
PS> $DebugPreference = "Continue"
PS> Write-Debug "Cannot open file."
DEBUG: Cannot open file.

Aby uzyskać więcej informacji na temat $DebugPreference, zobacz about_Preference_Variables.

Przykład 3. Użycie parametru debugowania w celu zastąpienia $DebugPreference

Funkcja Test-Debug zapisuje wartość zmiennej $DebugPreference na hoście programu PowerShell i strumieniu Debug. W tym przykładzie użyjemy parametru Debug, aby zastąpić wartość $DebugPreference.

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

Zwróć uwagę, że wartość $DebugPreference zmienia się podczas korzystania z parametru debugowania. Ta zmiana wpływa tylko na zakres funkcji. Nie ma to wpływu na wartość poza funkcją.

Aby uzyskać więcej informacji na temat wspólnego parametru debugowania , zobacz about_CommonParameters.

Parametry

-Message

Określa komunikat debugowania do wysłania do konsoli programu .

Typ:String
Aliasy:Msg
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

String

Możesz potokować ciąg zawierający komunikat debugowania do tego polecenia cmdlet.

Dane wyjściowe

None

To polecenie cmdlet nie zwraca żadnych danych wyjściowych. Zapisuje tylko w strumieniu debugowania.