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 Write-Debug cmdlet 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 to $DebugPreference 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ść na $DebugPreference 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 $DebugPreferenceprogramu , 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 debugowania. W tym przykładzie użyjemy parametru Debug , aby zastąpić $DebugPreference wartość.

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

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

Uwaga

Gdy wartość parametru $DebugPreference to Inquire, program PowerShell zatrzymuje wykonywanie, aby zapytać, czy wykonanie powinno być kontynuowane.

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.