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 $DebugPreferenceSilentlyContinue. 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 $DebugPreferenceKontynuuj, 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 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

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.