Delen via

Write-Debug

  • Referentie
Module:
Microsoft.PowerShell.Utility

Hiermee schrijft u een foutopsporingsbericht naar de console.

Syntaxis

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

Description

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

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

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 variabele $DebugPreference. Eerst geven we de huidige waarde van $DebugPreference weer en proberen 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_Variablesvoor 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 Debug 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 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

U ziet dat de waarde van $DebugPreference wordt gewijzigd 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.

Notitie

Wanneer de waarde van $DebugPreference is Inquire, stopt PowerShell de uitvoering om te vragen of de uitvoering moet worden voortgezet.

Zie about_CommonParametersvoor meer informatie over de Foutopsporing algemene parameter.

Parameters

-Message

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

Type:String
Aliassen:Msg
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

Invoerwaarden

String

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

Uitvoerwaarden

None

Write-Debug schrijft alleen naar de foutopsporingsstroom. Er wordt geen uitvoer geretourneerd.