Write-Debug
Escribe un mensaje de depuración en la consola.
Write-Debug [-Message] <string> [<CommonParameters>]
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.
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 |
Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.
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. |
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.
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.
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.
Write-Verbose
Write-Error
Write-Host
Write-Progress
Write-Output
Write-Warning