Write-Debug

Referentie

Module:: Microsoft.PowerShell.Utility

Hiermee wordt een foutopsporingsbericht naar de console geschreven.

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 deze weergeven met behulp van de parameter Foutopsporing 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: De parameter Foutopsporing gebruiken 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 Foutopsporing.

Parameters

-Message

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

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

Invoerwaarden

String

U kunt een tekenreeks met een foutopsporingsbericht doorsturen naar Write-Debug.

Uitvoerwaarden

None

Write-Debug schrijft alleen naar de foutopsporingsstroom. Er worden geen objecten naar de pijplijn geschreven.