Write-Debug

Syntax

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

Description

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 Felsök eller variabeln $DebugPreference .

Exempel

Exempel 1: Förstå $DebugPreference

Det här exemplet skriver ett felsökningsmeddelande.

Write-Debug "Cannot open file."

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

Exempel 2: Ändra värdet för $DebugPreference

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 $DebugPreference för 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.

Exempel 3: Använd felsökningsparametern för att åsidosätta $DebugPreference

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 Felsökning 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 ändringar när du använder felsökningsparametern. Den här ändringen påverkar bara funktionens omfång. Värdet påverkas inte utanför funktionen.

Mer information om den vanliga parametern Felsök finns i about_CommonParameters.

Parametrar

-Message

Indata

String

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

Utdata

None

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

Relaterade länkar

• about_Output_Streams
• about_Redirection
• Write-Error
• Write-Host
• Write-Output
• Write-Progress
• Write-Verbose
• Write-Warning