Utilice la información siguiente para depurar un script ejecutándolo paso a paso.

La ejecución paso a paso es el proceso de ejecutar una instrucción cada vez. Puede detenerse en una línea de código y examinar los valores de variables y el estado del sistema. En la tabla siguiente se describen tareas de depuración comunes como la ejecución paso a paso por procedimientos, la ejecución paso a paso por instrucciones y la ejecución paso a paso para salir.

Tarea de depuración

Descripción

Cómo realizarla en ISE de PowerShell

Paso a paso por instrucciones

Ejecuta la instrucción actual y, a continuación, se detiene en la siguiente instrucción. Si la instrucción actual es una llamada a un script o a una función, el depurador ejecuta paso a paso esa función o script; en caso contrario, se detiene en la siguiente instrucción.

En el Panel de comandos, escriba S y presione ENTRAR, o bien, en el menú Depuración, haga clic en Paso a paso por instrucciones.

Paso a paso por procedimientos

Ejecuta la instrucción actual y, a continuación, se detiene en la siguiente instrucción. Si la instrucción actual es una llamada a un script o a una función, el depurador ejecuta la función o el script completos y se detiene en la siguiente instrucción después de la llamada.

En el Panel de comandos, escriba V y presione ENTRAR, o bien, en el menú Depuración, haga clic en Paso a paso por procedimientos.

Paso a paso para salir

Ejecuta la función actual, sale de ella y asciende un nivel si la función está anidada. Si está en el cuerpo principal, el script se ejecuta hasta el final o hasta el siguiente punto de interrupción. Las instrucciones omitidas se ejecutan, pero no paso a paso.

En el Panel de comandos, escriba O y presione ENTRAR, o bien, en el menú Depuración, haga clic en Paso a paso para salir.

Continuar

Continúa la ejecución hasta el final o hasta el siguiente punto de interrupción. Las funciones e invocaciones omitidas se ejecutan, pero no paso a paso.

En el Panel de comandos, escriba C y presione ENTRAR, o bien, en el menú Depuración, haga clic en Ejecutar o continuar.

Depurar un script

  1. Establezca los puntos de interrupción en el código que desea examinar. Para obtener información sobre cómo se establecen puntos de interrupción, vea How to Set, Remove, Disable Enable, Disable, and List Breakpoints o Set-PSBreakpoint.

  2. En el menú Depuración, haga clic en Ejecutar o continuar, o bien, en la barra de herramientas, haga clic en Ejecutar script. Este es el proceso que se puede esperar:

    • La depuración empieza. El script se ejecuta hasta que encuentra el primer punto de interrupción y, a continuación, se detiene. El punto de interrupción se resalta.

    • El símbolo del sistema cambia y aparece el prefijo [DBG] en la barra del Panel de comandos.

    • Se muestra un mensaje acerca del punto de interrupción encontrado en el Panel de salida. Por ejemplo, "Punto de interrupción de línea encontrado en C:\Users\name\Desktop\test.script.ps1:13".

    El mensaje contiene el nombre de script y detalles sobre el punto de interrupción de línea, punto de interrupción de variable o punto de interrupción de comando.

  3. A partir de ese momento, puede realizar la ejecución paso a paso por procedimientos, paso a paso por instrucciones, paso a paso para salir o continuar. Si continúa, el depurador se ejecutará hasta el final del script o hasta el siguiente punto de interrupción.

  4. Para buscar el valor de una variable durante la depuración, mantenga el mouse sobre la variable en el Panel de scripts, o escriba el nombre de variable en el Panel de comandos, y presione ENTRAR. El Panel de salida mostrará el valor de la variable. Continúe ejecutando paso a paso el script o realice otras tareas de depuración.

Vea también




Tabla de contenido