Write-Debug

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

Cmdleten Write-Debug skriver felsökningsmeddelanden till värden från ett skript eller kommando.

Som standard visas inte felsökningsmeddelanden i konsolen, men du kan visa dem med hjälp av parametern Debug eller variabeln $DebugPreference.

Det här exemplet skriver ett felsökningsmeddelande.

Write-Debug "Cannot open file."

Standardvärdet för $DebugPreference är SilentlyContinue. Meddelandet visas därför inte i konsolen.

Det här exemplet visar effekten av att ändra värdet för variabeln $DebugPreference. Först visar vi det aktuella värdet för $DebugPreference och försöker skriva ett felsökningsmeddelande. Sedan ändrar vi värdet för $DebugPreference till Fortsätt, vilket gör att felsökningsmeddelanden kan visas.

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

Mer information om $DebugPreferencefinns i about_Preference_Variables.

Funktionen Test-Debug skriver värdet för variabeln $DebugPreference till PowerShell-värden och till felsökningsströmmen. I det här exemplet använder vi parametern Debug för att åsidosätta $DebugPreference-värdet.

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

Observera att värdet för $DebugPreference ändras när du använder parametern Debug. Den här ändringen påverkar bara funktionens omfång. Värdet påverkas inte utanför funktionen.

Mer information om parametern Debug common finns i about_CommonParameters.

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Du kan skicka en sträng som innehåller ett felsökningsmeddelande till den här cmdleten.

Den här cmdleten returnerar inga utdata. Den skriver bara till felsökningsströmmen.