Delen via

Write-Debug

  • Referentie
Module:
Microsoft.PowerShell.Utility

Schrijft 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 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 van $DebugPreference is SilentlyContinue. 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 wordt de huidige waarde van $DebugPreference weergegeven en wordt geprobeerd een foutopsporingsbericht te schrijven. Vervolgens wijzigen we de waarde van in $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 verandert 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 te verzenden naar de console.

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

Uitvoerwaarden

None

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