Write-Debug

  • Referens
Modul:
Microsoft.PowerShell.Utility

Skriver ett felsökningsmeddelande till konsolen.

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

Anger det felsökningsmeddelande som ska skickas till konsolen.

Type:String
Aliases:Msg
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

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.