Write-Debug
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 zmienimy 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
programu , zobacz about_Preference_Variables.
Przykład 3. Użyj parametru Debug, aby zastąpić $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 Continue
$DebugPreference is Continue
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ą.
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 .
Type: | String |
Aliases: | Msg |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Dane wejściowe
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.