Write-Debug

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

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 wel weergeven met behulp van de parameter Foutopsporing of de variabele $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.

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.

Voor meer informatie over $DebugPreference, zie about_Preference_Variables.

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 Continue
$DebugPreference is Continue
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.

Zie about_CommonParametersvoor meer informatie over de Foutopsporing algemene parameter.

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

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

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