Write-Debug

  • Referencia
Módulo:
Microsoft.PowerShell.Utility

Escribe un mensaje de depuración en la consola.

Syntax

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

Description

El Write-Debug cmdlet escribe mensajes de depuración en el host desde un script o comando.

De forma predeterminada, los mensajes de depuración no se muestran en la consola, pero puede mostrarlos mediante el parámetro Debug o la $DebugPreference variable .

Ejemplos

Ejemplo 1: Comprender $DebugPreference

En este ejemplo se escribe un mensaje de depuración.

Write-Debug "Cannot open file."

El valor predeterminado de $DebugPreference es SilentlyContinue. Por lo tanto, el mensaje no se muestra en la consola.

Ejemplo 2: Cambiar el valor de $DebugPreference

En este ejemplo se muestra el efecto de cambiar el valor de la $DebugPreference variable. En primer lugar, se muestra el valor actual de $DebugPreference e intentamos escribir un mensaje de depuración. A continuación, cambiamos el valor de $DebugPreference a Continue, que permite mostrar los mensajes de depuración.

PS> $DebugPreference
SilentlyContinue
PS> Write-Debug "Cannot open file."
PS>
PS> $DebugPreference = "Continue"
PS> Write-Debug "Cannot open file."
DEBUG: Cannot open file.

Para obtener más información sobre $DebugPreference, consulte about_Preference_Variables.

Ejemplo 3: Usar el parámetro Debug para invalidar $DebugPreference

La Test-Debug función escribe el valor de la $DebugPreference variable en el host de PowerShell y en la secuencia de depuración. En este ejemplo, se usa el parámetro Debug para invalidar el $DebugPreference valor.

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

Observe que el valor de $DebugPreference los cambios al usar el parámetro Debug . Este cambio solo afecta al ámbito de la función. El valor no se ve afectado fuera de la función.

Para obtener más información sobre el parámetro común de depuración , consulte about_CommonParameters.

Parámetros

-Message

Especifica el mensaje de depuración que se envía a la consola.

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

Entradas

String

Puede canalizar una cadena que contenga un mensaje de depuración a este cmdlet.

Salidas

None

Este cmdlet no devuelve ningún resultado. Solo escribe en la secuencia de depuración.