SCCM Task Sequence Debugger | The Best Tool to Debug TS

Let’s learn the SCCM Task Sequence Debugger feature. Starting with the SCCM 2203, the Task Sequence debugger features are no longer pre-release. This is the ultimate and Best tool to debug SCCM Task Sequence.

Hello everyone, let’s discuss How to Troubleshoot ConfigMgr Task Sequence with Debug option. Using task sequence debug, an SCCM administrator can easily troubleshoot the OSD deployment. Let’s see how the Debug Option can help you to troubleshoot the Task Sequence.

Also, by applying Task Sequence Debug, you can control and troubleshoot any task sequence deployment. This task sequence debugger you can mainly use for testing purposes. But make sure when you’re using a task sequence debug, it is deployed to a smaller group of device collections.

Patch My PC

IntroductionSCCM Task Sequence Debugger

Task sequence debugger, a new troubleshooting tool, was introduced in SCCM CB version 1906. An administrator can deploy the task sequence debug into a small collection for troubleshooting the OSD.

By deploying this task sequence, debug will allow an administrator to control each step of the task sequence to troubleshoot and investigate the issue. Task sequence debugger can be run on the same device during the task sequence deployment, not into a remote device.

let’s discuss below the pre-requisites required to use the Task sequence debugger.

Pre-requisites -SCCM Task Sequence Debugger

Make sure ConfigMgr clients are upgraded to the above 1906 version.

The task sequence debugger can be run if you log in as an administrator on a particular device.

If you’re deploying an OSD task sequence make sure your boot image is updated with the latest ConfigMgr client.

How to Use Task Sequence Debug Tool

Let’s try to use the SCCM Task Sequence Debugger tool using the following method.

  • In the ConfigMgr Console, go to Software Library, expand the Operating Systems and select Task Sequences.
  • Select the task sequence which you wanted to deploy using the ‘Debug‘ tool.
  • Then ‘Right-click‘ on the task sequence and select ‘Debug
How to Troubleshoot ConfigMgr Task Sequence with Debug option | SCCM SCCM Task Sequence Debugger | The Tool to Debug TS
Task Sequence Debug: Troubleshoot ConfigMgr Task Sequence with Debug option | SCCM SCCM Task Sequence Debugger | The Tool to Debug TS 1

Select the collection for debugging deployment and click ‘Next‘.

Note!- The task sequence debug deployment option only displays 10 or fewer members of device collections.

How to Troubleshoot ConfigMgr Task Sequence with Debug option | SCCM 2
SCCM Task Sequence Debugger | The Tool to Debug TS 2

According to my testing, you cannot use debug for the required deployment. The option was gyred out.

How to Troubleshoot ConfigMgr Task Sequence with Debug option | SCCM
SCCM Task Sequence Debugger | The Tool to Debug TS

Click ‘Next‘ -> schedule the deployment and click ‘Next‘. In the ‘User Experience‘ section I noticed that you cannot uncheck the option for “Show Task Sequence Progress.”

SCCM Task Sequence Debugger | The Tool to Debug TS
SCCM Task Sequence Debugger | The Tool to Debug TS

Click Next -> Next to finalize the deployment. Once the task sequence deployment started on the machine, the Task Sequence Debugger window will open.

SCCM Task Sequence Debugger | The Tool to Debug TS
SCCM Task Sequence Debugger | The Tool to Debug TS

Options SCCM Task Sequence Debugger | The Tool to Debug TS

Below controls are included in the debugger tool. SCCM Task Sequence Debugger | The Tool to Debug TS tool options.

  • Step: You can run the next step of the task sequence from the current position.
  • Run: If you set a break in any step of the task sequence then click on run to proceed.
  • Set Current: Select a task sequence step then select Set Current. This action moves the current pointer to that step. This action allows you to skip steps or move backward.
  • Set Break: Select a task sequence step in the debugger and then select Set Break. This action adds a breakpoint to the debugger. When you run the task sequence, it stops at a break.

Another list of additional features with the SCCM TS Debugger tool.

  • Clear All Breaks: It will remove all breakpoints.
  • Log File: It will open the task sequence log file smsts.log in the CMTrace tool.
  • Cmd Prompt: If you deployed a task sequence that has WinPE, then it will open a command prompt.
  • Cancel: It will close the debugger and the task sequence will be failed.
  • Quit: It will also close the debugger, but the task sequence will continue normally.

Debug Task Sequence Related Queries

There is another post from Vimal on this topic and he tasks about how to enable Task Sequence Debugger using the Task Sequence variable.

Debug Task Sequence Option is available for all SCCM?

Yes. The minimum client version should be 1906

Where is Debug Task sequence option?

Operating System – Task Sequence node

Debug Tool is an additional Tool that needs to be installed separately?

No. It’s integrated into Console by default.

Resources

Author

Debabrata Pati has more than 7+ years of experience in IT. Skilled in MEMCM, Azure, and Powershell. More than five (5) years of experience in MEMCM (SCCM) administration, OSD, and Troubleshooting for the environment with more than 100K client devices.

Leave a Comment

This site uses Akismet to reduce spam. Learn how your comment data is processed.