Write-Debug
Zapisuje komunikat debugowania w konsoli programu .
Składnia
Default (Domyślna)
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."
Domyślna wartość $DebugPreference to SilentlyContinue. W związku z tym komunikat nie jest wyświetlany w konsoli.
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 .
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | Msg |
Zestawy parametrów
(All)
| Position: | 0 |
| Obowiązkowy: | True |
| Wartość z potoku: | True |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
CommonParameters
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.
Dane wejściowe
String
Możesz przekazać 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.
