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