Write-Debug

Syntax

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

Description

Cmdleten Write-Debug skriver felsökningsmeddelanden till konsolen 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.

Exempel

Exempel 1: Förstå $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.

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 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.

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 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 Inquire

Confirm
Continue with this operation?
[Y] Yes  [A] Yes to All  [H] Halt Command  [?] Help (default is "Y"):
$DebugPreference is Inquire
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.

Parametrar

-Message

Indata

String

Du kan skicka en sträng som innehåller ett felsökningsmeddelande till Write-Debug.

Utdata

None

Write-Debug skriver bara till felsökningsströmmen. Det returnerar inga utdata.

Relaterade länkar

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