Depurar una secuencia de tareas

  • Artículo

Se aplica a: Configuration Manager (rama actual)

El depurador de secuencia de tareas es una herramienta de solución de problemas. Una secuencia de tareas se implementa en modo de depuración en una colección pequeña. Le permite recorrer la secuencia de tareas de forma controlada para ayudar a solucionar problemas e investigar. El depurador se ejecuta actualmente en el mismo dispositivo que el motor de secuencia de tareas, no es un depurador remoto.

Sugerencia

Esta característica se introdujo por primera vez en la versión 1906 como una característica de versión preliminar. A partir de la versión 2203, ya no es una característica de versión preliminar.

Configuration Manager no habilita esta característica opcional de forma predeterminada. Antes de usarlo, debe habilitar esta característica. Para obtener más información, consulte Habilitar características opcionales de las actualizaciones.

Requisitos previos

  • Actualización del cliente de Configuration Manager en el dispositivo de destino

  • Inicie sesión en el dispositivo de destino como usuario en el grupo administradores local. El depurador solo se ejecuta para administradores.

  • Actualice la imagen de arranque asociada a la secuencia de tareas para asegurarse de que tiene la versión de cliente más reciente.

Iniciar la herramienta

  1. En la consola de Configuration Manager, vaya al área de trabajo Biblioteca de software, expanda Sistemas operativos y seleccione Secuencias de tareas.

  2. Seleccione una secuencia de tareas. En el grupo Implementación de la cinta de opciones, seleccione Depurar.

    Sugerencia

    Como alternativa, establezca la variable TSDebugModeTRUE en en una colección o un objeto de equipo en el que se implementa la secuencia de tareas. Cualquier dispositivo que tenga esta variable establecida colocará cualquier secuencia de tareas implementada en él en modo de depuración.

  3. Cree una implementación de depuración. La configuración de implementación es la misma que la de una implementación de secuencia de tareas normal. Para obtener más información, consulte Implementación de una secuencia de tareas.

    Nota:

    Solo puede seleccionar una recopilación pequeña para una implementación de depuración. Solo muestra colecciones de dispositivos con 10 miembros o menos.

Use la variable de secuencia de tareas TSDebugOnError para iniciar automáticamente el depurador cuando la secuencia de tareas devuelva un error. Para obtener más información, vea Variables de secuencia de tareas: TSDebugOnError.

Uso de la herramienta

Cuando la secuencia de tareas se ejecuta en el dispositivo, la ventana Depurador de secuencia de tareas se abre de forma similar a la siguiente captura de pantalla:

Captura de pantalla del depurador de secuencia de tareas.

El depurador incluye los siguientes controles:

  • Paso: desde la posición actual , ejecute solo el paso siguiente en la secuencia de tareas.

    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. Este comportamiento le ofrece la opción de volver a intentar un paso después de realizar un cambio externo.

  • Ejecutar: desde la posición actual , ejecute la secuencia de tareas normalmente hasta el final, el siguiente punto de interrupción o si se produce un error en un paso. Antes de usar esta acción, asegúrese de establecer los puntos de interrupción con la acción Establecer interrupción .

  • Establecer actual: seleccione un paso en el depurador y, a continuación, seleccione Establecer actual. Esta acción mueve el puntero actual a ese paso. Esta acción le permite omitir pasos o retroceder.

    Advertencia

    El depurador no tiene en cuenta el tipo de paso al cambiar la posición actual en la secuencia. Algunos pasos pueden establecer variables de secuencia de tareas necesarias para la evaluación de condición en pasos posteriores. Si se queda sin orden, algunos pasos pueden producir errores o causar daños significativos en un dispositivo. Use esta opción a su propio riesgo.

  • Establecer interrupción: seleccione un paso en el depurador y, a continuación, seleccione Establecer interrupción. Esta acción agrega un punto de interrupción en el depurador. Cuando se ejecuta la secuencia de tareas, se detiene en un salto.

    • Antes de usar la acción Ejecutar , establezca puntos de interrupción.

    • Si crea un punto de interrupción en el depurador y, a continuación, la secuencia de tareas reinicia el equipo, el depurador mantiene los puntos de interrupción después del reinicio.

  • Borrar todos los saltos: quite todos los puntos de interrupción.

  • Archivo de registro: abre el archivo de registro de secuencia de tareas actual, smsts.log, con CMTrace. Puede ver entradas de registro cuando el motor de secuencia de tareas es "Esperando al depurador".

  • Símbolo del sistema: en Windows PE, abre un símbolo del sistema.

  • Cancelar: cierre el depurador y produzca un error en la secuencia de tareas.

  • Salir: desasocie y cierre el depurador, pero la secuencia de tareas continúa ejecutándose con normalidad.

La ventana Variables de secuencia de tareas muestra los valores actuales de todas las variables del entorno de secuencia de tareas. Para obtener más información, vea Variables de secuencia de tareas. Si usa el paso Establecer variable de secuencia de tareas con la opción No mostrar este valor, el depurador no muestra el valor de la variable. No se pueden editar los valores de variable en el depurador.

Nota:

Algunas variables de secuencia de tareas son solo para uso interno y no se enumeran en la documentación de referencia.

El depurador de secuencia de tareas continúa ejecutándose después de un paso Reiniciar equipo . El depurador mantiene los puntos de interrupción después del reinicio. Aunque la secuencia de tareas puede no requerirla, dado que el depurador requiere la interacción del usuario, debe iniciar sesión en Windows para continuar. Si no inicia sesión después de una hora para continuar la depuración, se produce un error en la secuencia de tareas.

También entra en una secuencia de tareas secundaria con el paso Ejecutar secuencia de tareas . La ventana del depurador muestra los pasos de la secuencia de tareas secundaria junto con la secuencia de tareas principal.

Problemas conocidos

Si tiene como destino una implementación normal y una implementación de depuración en el mismo dispositivo a través de varias implementaciones, es posible que el depurador de secuencia de tareas no se inicie.

Vea también