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.
Introduction – SCCM 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‘
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.
According to my testing, you cannot use debug for the required deployment. The option was gyred out.
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.”
Click Next -> Next to finalize the deployment. Once the task sequence deployment started on the machine, the Task Sequence Debugger window will open.
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
- Microsoft Docs – https://docs.microsoft.com/en-us/mem/configmgr/osd/deploy-use/debug-task-sequence
- SCCM OSD Troubleshooting using SMSTS Log with Vishal | ConfigMgr
- SCCM OSD SMSTS Log File Reading Tips | ConfigMgr | MEMCM
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.