Depurar una secuencia de tareasDebug a task sequence

Se aplica a: Configuration Manager (rama actual)Applies to: Configuration Manager (current branch)

A partir de la versión 1906, el depurador de secuencias de tareas es una nueva herramienta para la solución de problemas.Starting in version 1906, the task sequence debugger is a new troubleshooting tool. Se implementa una secuencia de tareas en modo de depuración en una pequeña colección.You deploy a task sequence in debug mode to a small collection. Le permite recorrer la secuencia de tareas de una manera controlada para facilitar la investigación y la resolución de problemas.It lets you step through the task sequence in a controlled manner to aid troubleshooting and investigation. Actualmente, el depurador se ejecuta en el mismo dispositivo que el motor de secuencia de tareas, no se trata de un depurador remoto.The debugger currently runs on the same device as the task sequence engine, it's not a remote debugger.

Nota

En esta versión de Configuration Manager, el depurador de secuencias de tareas es una característica de versión preliminar.In this version of Configuration Manager, the task sequence debugger is a pre-release feature. Para habilitarla, vea Características de versión preliminar.To enable it, see Pre-release features.

Requisitos previosPrerequisites

  • Actualice al cliente de Configuration Manager en el dispositivo de destino.Update the Configuration Manager client on the target device

  • Inicie sesión en el dispositivo de destino como usuario en el grupo local de Administradores.Sign in to the target device as a user in the local Administrators group. El depurador solo pueden ejecutarlo administradores.The debugger only runs for administrators.

  • Actualice la imagen de arranque asociada a la secuencia de tareas para asegurarse de que tiene la versión más reciente del cliente.Update the boot image associated with the task sequence to make sure it has the latest client version

Inicio de la herramientaStart the tool

  1. En la consola de Configuration Manager, vaya al área de trabajo Biblioteca de software, expanda Sistemas operativos y haga clic en Secuencias de tareas.In the Configuration Manager console, go to the Software Library workspace, expand Operating Systems, and select Task Sequences.

  2. Seleccione una secuencia de tareas.Select a task sequence. En el grupo Implementación de la cinta, seleccione Depurar.In the Deployment group of the ribbon, select Debug.

    Sugerencia

    Como alternativa, establezca la variable TSDebugMode en TRUE en una colección en la que se haya implementado la secuencia de tareas, o bien en un objeto de equipo en el que también se hayan implementado.Alternatively, set the variable TSDebugMode to TRUE on a collection or computer object to which the task sequence is deployed. Cualquier dispositivo que tenga este conjunto de variables colocará cualquier secuencia de tareas implementada en el modo de depuración.Any device that has this variable set will put any task sequence deployed to it into debug mode.

  3. Cree una implementación de depuración.Create a debug deployment. La configuración de la implementación es la misma que la de una implementación de una secuencia de tareas normal.The deployment settings are the same as a normal task sequence deployment. Para obtener más información, vea Deploy a task sequence.For more information, see Deploy a task sequence.

    Nota

    Solo puede seleccionar una colección pequeña para una implementación de depuración.You can only select a small collection for a debug deployment. Solo se mostrarán las colecciones de dispositivos con 10 miembros o menos.It only displays device collections with 10 or less members.

A partir de la versión 1910, use la nueva variable de secuencia de tareas TSDebugOnError para iniciar automáticamente el depurador cuando la secuencia de tareas devuelva un error.Starting in version 1910, use the new task sequence variable TSDebugOnError to automatically start the debugger when the task sequence returns an error. Para obtener más información, vea Variables de secuencia de tareas: TSDebugOnError.For more information, see Task sequence variables - TSDebugOnError.

Uso de la herramientaUse the tool

Cuando la secuencia de tareas se ejecuta en el dispositivo, se abre la ventana del depurador de secuencia de tareas, como en la captura de pantalla siguiente:When the task sequence runs on the device, the Task Sequence Debugger window opens similar to the following screenshot:

Captura de pantalla del depurador de secuencia de tareas

El depurador incluye los controles siguientes:The debugger includes the following controls:

  • Step (Paso): desde la posición actual, ejecute solo el paso siguiente de la secuencia de tareas.Step: From the current position, run only the next step in the task sequence.

    Nota

    Cuando la secuencia de tareas está en modo de depuración, si un paso devuelve un error irrecuperable, la secuencia de tareas no produce un error normal.When the task sequence is in debug mode, if a step returns a fatal error, the task sequence doesn't fail as normal. Este comportamiento le ofrece la opción de volver a intentar un paso después de realizar un cambio externo.This behavior gives you the option to retry a step after you make an external change.

  • Ejecutar: desde la posición actual, ejecute la secuencia de tareas con normalidad hasta el final o el próximo punto de interrupción, o si hay error en un paso.Run: From the current position, run the task sequence normally to the end, the next break point, or if a step fails. Antes de usar esta acción, asegúrese de establecer los puntos de interrupción con la acción Establecer interrupción.Before you use this action, make sure to set any break points with the Set Break action.

  • Set Current (Establecer actual): seleccione un paso en el depurador y, después, seleccione Set Current.Set Current: Select a step in the debugger and then select Set Current. Esta acción mueve el puntero actual a ese paso.This action moves the current pointer to that step. Esta acción permite omitir pasos o retroceder.This action allows you to skip steps or move backwards.

    Advertencia

    El depurador no considera el tipo de paso cuando se cambia la posición actual en la secuencia.The debugger doesn't consider the type of step when you change the current position in the sequence. Algunos pasos pueden establecer variables de secuencia de tareas que se necesitan para la evaluación de condiciones en pasos posteriores.Some steps may set task sequence variables that are required for condition evaluation by later steps. Si se ejecutan de forma desordenada, algunos pasos pueden producir un error o causar daños importantes en un dispositivo.If run out of order, some steps may fail or cause significant damage to a device. Use esta opción bajo su responsabilidad.Use this option at your own risk.

  • Set Break (Establecer punto de interrupción): seleccione un paso en el depurador y, después, seleccione Set Break.Set Break: Select a step in the debugger and then select Set Break. Esta acción agrega un punto de interrupción al depurador.This action adds a break point in the debugger. Cuando se ejecuta la secuencia de tareas, se detiene en un punto de interrupción.When you Run the task sequence, it stops at a break.

    • Antes de usar la acción Ejecutar, establezca puntos de interrupción.Before you use the Run action, set break points.

    • A partir de la versión 1910, si crea un punto de interrupción en el depurador y, a continuación, la secuencia de tareas reinicia el equipo, el depurador mantiene el punto de interrupción después del reinicio.Starting in version 1910, if you create a break point in the debugger, and then the task sequence restarts the computer, the debugger keeps your break points after restart.

    • En la versión 1906, los puntos de interrupción no se guardan después de que se reinicie el equipo, como con el paso Reiniciar el equipo.In version 1906, break points aren't saved after the computer restarts, like with the Restart Computer step. Por ejemplo, si inicia el depurador desde el Centro de software para una secuencia de tareas de creación de imágenes, no establezca interrupciones en la fase de Windows PE.For example, if you start the debugger from Software Center for an imaging task sequence, don't set breaks in the Windows PE phase. Cuando el equipo se reinicia en Windows PE, el depurador pausa la secuencia de tareas para que pueda establecer interrupciones.When the computer restarts into Windows PE, the debugger pauses the task sequence so that you can set breaks.

  • Borrar todas las interrupciones: quita todos los puntos de interrupción.Clear All Breaks: Remove all break points.

  • Archivo de registro: abre el archivo de registro de la secuencia de tareas actual, smsts.log, con CMTrace.Log File: Opens the current task sequence log file, smsts.log, with CMTrace. Puede ver las entradas del registro cuando el motor de secuencia de tareas está "esperando al depurador".You can see log entries when the task sequence engine is "Waiting for the debugger."

  • Símbolo del sistema cmd: en Windows PE, abre un símbolo del sistema.Cmd Prompt: In Windows PE, opens a command prompt.

  • Cancelar: cierra el depurador y produce un error en la secuencia de tareas.Cancel: Close the debugger, and fail the task sequence.

  • Quit (Salir): desasocia y cierra el depurador, pero la secuencia de tareas continúa ejecutándose con normalidad.Quit: Detach and close the debugger, but the task sequence continues to run normally.

La ventana Variables de secuencias de tareas muestra los valores actuales de todas las variables en el entorno de la secuencia de tareas.The Task Sequence Variables window shows the current values for all variables in the task sequence environment. Para más información, vea Task sequence variables (Variables de secuencia de tareas).For more information, see Task sequence variables. Si usa el paso Establecer variable de secuencia de tareas con la opción No mostrar este valor, el depurador no mostrará el valor de la variable.If you use the Set Task Sequence Variable step with the option to Do not display this value, the debugger doesn't display the variable value. No se pueden editar los valores de las variables en el depurador.You can't edit the variable values in the debugger.

Nota

Algunas variables de secuencias de tareas son solo para uso interno y no se incluyen en la documentación de referencia.Some task sequence variables are for internal use only, and not listed in the reference documentation.

El depurador de secuencias de tareas continúa ejecutándose después de un paso Reiniciar el equipo, pero debe volver a crear los puntos de interrupción.The task sequence debugger continues to run after a Restart Computer step, but you need to recreate any break points. Aunque es posible que la secuencia de tareas no necesite la interacción del usuario, como el depurador sí la requiere, debe iniciar sesión en Windows para continuar.Even though the task sequence may not require it, since the debugger requires user interaction, you need to sign in to Windows to continue. Si no inicia sesión después de una hora para continuar con la depuración, se produce un error en la secuencia de tareas.If you don't sign in after one hour to continue debugging, the task sequence fails.

También se pasa a una secuencia de tareas secundaria con el paso Ejecutar secuencia de tareas.It also steps into a child task sequence with the Run Task Sequence step. La ventana del depurador muestra los pasos de la secuencia de tareas secundaria junto con la secuencia de tareas principal.The debugger window shows the steps of the child task sequence along with the main task sequence.

Problemas conocidosKnown issues

Si establece una implementación normal y una implementación de depuración como destino del mismo dispositivo a través de varias implementaciones, es posible que el depurador de la secuencia de tareas no se inicie.If you target both a normal deployment and debug deployment to the same device through multiple deployments, the task sequence debugger may not launch.

Vea tambiénSee also