Dela via

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

Kommentar

När värdet $DebugPreference för är Fråga stoppar PowerShell körningen för att fråga om körningen ska fortsätta.

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.