Delen via

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.

Standaard worden foutopsporingsberichten 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 geven we de huidige waarde van $DebugPreference weer en proberen we een foutopsporingsbericht te schrijven. Vervolgens wijzigen we de waarde van $DebugPreference in Doorgaan, 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 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. Er wordt alleen naar de foutopsporingsstroom geschreven.