Set-PSDebug

Activa o desactiva las características de depuración de scripts, establece el nivel de seguimiento y alterna el modo estricto.

Sintaxis

Set-PSDebug [-Off] [<CommonParameters>]

Set-PSDebug [-Step] [-Strict] [-Trace <int>] [<CommonParameters>]

Descripción

El cmdlet Set-PSDebug activa o desactiva las características de depuración de script, establece el nivel de seguimiento y alterna el modo estricto.

Cuando el parámetro Trace se establece en 1, se realiza el seguimiento de cada línea de script al ejecutarse. Cuando el parámetro se establece en 2, también se realiza el seguimiento de las asignaciones de variables y de las llamadas a funciones y scripts. Si se especifica el parámetro Step, se solicitará confirmación antes de ejecutarse cada línea del script.

Parámetros

-Off

Desactiva todas las características de depuración de scripts.

Nota: el comando "Set-StrictMode -off" deshabilita la comprobación establecida por un comando "set-psdebug -strict". Para obtener más información, vea Set-StrictMode.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-Step

Activa la ejecución paso a paso de scripts. Antes de que se ejecute cada línea, se pregunta al usuario si desea detenerse, continuar o especificar un nuevo nivel del intérprete para inspeccionar el estado del script.

Nota: la especificación del parámetro Step establece automáticamente el nivel de seguimiento 1.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-Strict

Especifica que el intérprete debe producir una excepción si se hace referencia a una variable antes de que se le asigne un valor.

Nota: el comando "Set-StrictMode -off" deshabilita la comprobación establecida por un comando "set-psdebug -strict". Para obtener más información, vea Set-StrictMode.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-Trace <int>

Especifica el nivel de seguimiento:

0: desactiva el seguimiento de scripts

1: realiza un seguimiento de las líneas de script conforme se ejecutan

2: realiza un seguimiento de las líneas de script, las asignaciones de variables, las llamadas a funciones y los scripts.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

false

¿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

Ninguno

No se pueden canalizar entradas a este cmdlet.

Salidas

Ninguno

Este cmdlet no devuelve resultados.

Ejemplo 1

C:\PS>set-psdebug -trace 2; foreach ($i in 1..3) {$i}

DEBUG:    1+ Set-PsDebug -trace 2; foreach ($i in 1..3) {$i}
DEBUG:    1+ Set-PsDebug -trace 2; foreach ($i in 1..3) {$i}
1
DEBUG:    1+ Set-PsDebug -trace 2; foreach ($i in 1..3) {$i}
2
DEBUG:    1+ Set-PsDebug -trace 2; foreach ($i in 1..3) {$i}
3

Descripción
-----------
Este comando establece el nivel de seguimiento en 2 y, a continuación, ejecuta un script que muestra los números 1, 2 y 3.





Ejemplo 2

C:\PS>set-psdebug -step; foreach ($i in 1..3) {$i}

DEBUG:    1+ Set-PsDebug -step; foreach ($i in 1..3) {$i}
Continue with this operation?
   1+ Set-PsDebug -step; foreach ($i in 1..3) {$i}
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help
(default is "Y"):a
DEBUG:    1+ Set-PsDebug -step; foreach ($i in 1..3) {$i}
1
2
3

Descripción
-----------
Este comando activa la ejecución paso a paso y, a continuación, 
ejecuta un script que muestra los números 1, 2 y 3.





Ejemplo 3

C:\PS>set-psdebug -off; foreach ($i in 1..3) {$i}

1
2
3

Descripción
-----------
Este comando desactiva todas las características de depuración y, a continuación, ejecuta un script que muestra los números 1, 2 y 3.





Ejemplo 4

C:\PS>set-psdebug -strict; $NewVar

The variable $NewVar cannot be retrieved because it has not been set yet.
At line:1 char:28
+ Set-PsDebug -strict;$NewVar <<<<

Descripción
-----------
Este comando establece el intérprete en modo estricto e intenta tener acceso a una variable que todavía no se ha establecido.





Vea también

Conceptos

about_Debuggers
Debug-Process
Set-PSBreakpoint
Set-StrictMode
Write-Debug