Write-Debug

  • Referentie
Module:
Microsoft.PowerShell.Utility

Hiermee schrijft u een foutopsporingsbericht naar de console.

Syntax

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

Description

De Write-Debug cmdlet schrijft foutopsporingsberichten naar de host vanuit een script of opdracht.

Foutopsporingsberichten worden standaard niet weergegeven in de console, maar u kunt ze wel weergeven met behulp van de parameter Debug of de $DebugPreference variabele.

Voorbeelden

Voorbeeld 1: Inzicht in $DebugPreference

In dit voorbeeld wordt een foutopsporingsbericht geschreven.

Write-Debug "Cannot open file."

De standaardwaarde is $DebugPreferenceSilentlyContinue. Daarom wordt het bericht niet weergegeven in de console.

Voorbeeld 2: de waarde van $DebugPreference wijzigen

In dit voorbeeld ziet u het effect van het wijzigen van de waarde van de $DebugPreference variabele. Eerst geven we de huidige waarde weer van $DebugPreference en proberen een foutopsporingsbericht te schrijven. Vervolgens wijzigen we de waarde van $DebugPreferenceDoorgaan, waardoor foutopsporingsberichten kunnen worden weergegeven.

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

Zie about_Preference_Variables voor meer informatie over$DebugPreference.

Voorbeeld 3: gebruik de parameter Foutopsporing om $DebugPreference te overschrijven

De Test-Debug functie schrijft de waarde van de $DebugPreference variabele naar de PowerShell-host en naar de foutopsporingsstroom. In dit voorbeeld gebruiken we de parameter Foutopsporing om de $DebugPreference waarde te overschrijven.

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

U ziet dat de waarde van $DebugPreference wijzigingen wanneer u de parameter Foutopsporing gebruikt. Deze wijziging is alleen van invloed op het bereik van de functie. De waarde wordt niet beïnvloed buiten de functie.

Zie about_CommonParameters voor meer informatie over de algemene parameter Debug.

Parameters

-Message

Hiermee geeft u het foutopsporingsbericht op dat naar de console moet worden verzonden.

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

Invoerwaarden

String

U kunt een tekenreeks met een foutopsporingsbericht doorsturen naar deze cmdlet.

Uitvoerwaarden

None

Deze cmdlet retourneert geen uitvoer. Het schrijft alleen naar de foutopsporingsstroom.