Compartir vía

Write-Debug

Módulo:
Microsoft.PowerShell.Utility Module

Escribe un mensaje de depuración en la consola.

Sintaxis

Default (Es el valor predeterminado). 

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 y se intenta 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 Debug 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 de 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 Debug, consulte about_CommonParameters.

Parámetros

-Message

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

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:Msg

Conjuntos de parámetros

(All)
Posición:0
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

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.