Compartir a través de

Write-Debug

  • Referencia
Módulo:
Microsoft.PowerShell.Utility

Escribe un mensaje de depuración en la consola.

Sintaxis

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

Description

El cmdlet Write-Debug 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 Depurar o la variable $DebugPreference.

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 variable $DebugPreference. 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, vea about_Preference_Variables.

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

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

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 cambia cuando se usa el parámetro Depuración. 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 de, consulte about_CommonParameters.

Parámetros

-Message

Especifica el mensaje de depuración que se va a enviar a la consola.

Tipo:String
Alias:Msg
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

Entradas

String

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

Salidas

None

Este cmdlet no devuelve ninguna salida. Solo escribe en la secuencia de depuración.