Write-Debug
Escribe un mensaje de depuración en la consola.
Sintaxis
Write-Debug [-Message] <string> [<CommonParameters>]
Descripción
El cmdlet Write-Debug escribe mensajes de depuración en la consola desde un script o un comando.
De forma predeterminada, los mensajes de depuración no se muestran en la consola, pero se pueden mostrar mediante el parámetro Debug o la variable $DebugPreference.
Parámetros
-Message <string>
Especifica el mensaje de depuración que se va a enviar a la consola.
¿Requerido? |
true |
¿Posición? |
1 |
Valor predeterminado |
|
¿Aceptar canalización? |
true (ByValue) |
¿Aceptar caracteres comodín? |
false |
<CommonParameters>
Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.
Entradas y salidas
El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet. El tipo devuelto es el tipo de los objetos que el cmdlet devuelve.
Entradas |
System.String Puede canalizar a Write-Debug una cadena que contiene un mensaje de depuración. |
Salidas |
Ninguno Write-Debug escribe únicamente en la secuencia de depuración. No devuelve ningún resultado. |
Ejemplo 1
C:\PS>Write-Debug "Cannot open file."
Descripción
-----------
Este comando escribe un mensaje de depuración. Dado que el valor de $DebugPreference es "SilentlyContinue", el mensaje no se muestra en la consola.
Ejemplo 2
C:\PS>$DebugPreference
SilentlyContinue
C:\PS> Write-Debug "Cannot open file."
C:\PS>
C:\PS> Write-Debug "Cannot open file." -debug
DEBUG: Cannot open file.
Descripción
-----------
En este ejemplo se muestra cómo utilizar el parámetro común Debug para invalidar el valor de la variable $DebugPreference para un comando determinado.
El primer comando muestra el valor de la variable $DebugPreference, que es el valor predeterminado "SilentlyContinue".
El segundo comando escribe un mensaje de depuración pero, debido al valor de $DebugPreference, el mensaje no aparece.
El tercer comando escribe un mensaje de depuración. Utiliza el parámetro común Debug para invalidar el valor de $DebugPreference y mostrar los mensajes de depuración generados por este comando.
Como resultado, aunque el valor de $DebugPreference es "SilentlyContinue", el mensaje de depuración aparece.
Para obtener más información sobre el parámetro común Debug, vea about_CommonParameters.
Ejemplo 3
C:\PS>$DebugPreference
SilentlyContinue
C:\PS> Write-Debug "Cannot open file."
C:\PS>
C:\PS> $DebugPreference = "Continue"
C:\PS> Write-Debug "Cannot open file."
DEBUG: Cannot open file.
Descripción
-----------
Este comando muestra el efecto de cambiar el valor de la variable $DebugPreference en la presentación de los mensajes de depuración.
El primer comando muestra el valor de la variable $DebugPreference, que es el valor predeterminado "SilentlyContinue".
El segundo comando escribe un mensaje de depuración pero, debido al valor de $DebugPreference, el mensaje no aparece.
El tercer comando asigna el valor "Continue" a la variable $DebugPreference.
El cuarto comando escribe un mensaje de depuración, que aparece en la consola.
Para obtener más información sobre $DebugPreference, vea about_Preference_Variables.
Vea también
Conceptos
Write-Verbose
Write-Error
Write-Host
Write-Progress
Write-Output
Write-Warning