调试任务序列

适用于: Configuration Manager(current branch)

任务序列调试程序是一种故障排除工具。 将调试模式下的任务序列部署到小型集合。 它允许以受控方式逐步执行任务序列,以帮助故障排除和调查。 调试器当前在与任务序列引擎相同的设备上运行,它不是远程调试器。

提示

此功能在版本 1906 中首次作为 预发布功能引入。 从版本 2203 开始,它不再是预发布功能。

默认情况下,Configuration Manager 不启用此可选功能。 使用前,需要启用此功能。 有关详细信息,请参阅启用更新中的可选功能。

先决条件

  • 更新目标设备上的 Configuration Manager 客户端

  • 以本地 Administrators 组中的用户身份登录到目标设备。 调试器仅针对管理员运行。

  • 更新与任务序列关联的启动映像,以确保它具有最新的客户端版本

启动工具

  1. 在 Configuration Manager 控制台中,转到“软件库”工作区,展开“操作系统”,然后选择“任务序列”。

  2. 选择一个任务序列。 在功能区的“部署”组中,选择 “调试”。

    提示

    或者,将任务序列部署到的集合或计算机对象上的变量 TSDebugMode 设置为 TRUE 。 任何设置了此变量的设备都会将部署到它的任何任务序列置于调试模式。

  3. 创建调试部署。 部署设置与正常的任务序列部署相同。 有关详细信息,请参阅 部署任务序列。

    注意

    只能为调试部署选择一小部分集合。 它仅显示成员不超过 10 个的设备集合。

使用任务序列变量 TSDebugOnError 可以在任务序列返回错误时自动启动调试器。 有关详细信息,请参阅 任务序列变量 - TSDebugOnError。

使用该工具

当任务序列在设备上运行时,任务序列调试程序窗口将打开,类似于以下屏幕截图:

任务序列调试程序的屏幕截图。

调试器包括以下控件:

  • 步骤:从 当前 位置开始,仅运行任务序列中的下一步。

    注意

    当任务序列处于调试模式时,如果某个步骤返回致命错误,则任务序列不会正常失败。 此行为允许您选择在进行外部更改后重试步骤。

  • 运行:从 当前 位置正常运行任务序列,直到末尾、下一个 断点 或某个步骤失败时运行。 在使用此操作之前,请确保使用“ 设置中断 ”操作设置任何断点。

  • 设置当前:在调试器中选择一个步骤,然后选择“ 设置当前”。 此操作会将 当前 指针移动到该步骤。 此操作允许跳过步骤或向后移动。

    警告

    当您更改序列中的当前位置时,调试器不会考虑步骤的类型。 某些步骤可能会设置后续步骤条件评估所需的任务序列变量。 如果出现故障,某些步骤可能会失败或对设备造成严重损坏。 使用此选项需要自担风险。

  • 设置中断:在调试器中选择一个步骤,然后选择“ 设置中断”。 此操作在调试程序中添加 断点 。 运行任务序列时,它会在休息时停止。

    • 在使用 “运行 ”操作之前,请设置断点。

    • 如果在调试器中创建断点,然后任务序列重新启动计算机,则调试器将在重启后保留断点。

  • 清除所有中断点:删除所有中断点。

  • 日志文件:使用 CMTrace 打开当前任务序列日志文件 smsts.log。 当任务序列引擎“正在等待调试器”时,可以看到日志条目。

  • Cmd 提示符:在 Windows PE 中,打开命令提示符。

  • 取消:关闭调试器,使任务序列失败。

  • 退出:分离并关闭调试器,但任务序列继续正常运行。

“ 任务序列变量 ”窗口显示任务序列环境中所有变量的当前值。 有关详细信息,请参阅 任务序列变量。 如果使用带有“不显示此值”选项的“设置任务序列变量”步骤,则调试程序不会显示变量值。 无法在调试器中编辑变量值。

注意

某些任务序列变量仅供内部使用,参考文档中未列出。

执行“ 重启计算机” 步骤后,任务序列调试程序将继续运行。 调试程序在重启后保留断点。 即使任务序列可能不需要它,但由于调试程序需要用户交互,你需要登录到 Windows 才能继续。 如果一小时后未登录以继续调试,则任务序列将失败。

它还使用“ 运行任务序列 ”步骤单步执行子任务序列。 调试器窗口显示子任务序列的步骤以及主任务序列。

已知问题

如果通过多个部署同时针对同一设备的正常部署和调试部署,则任务序列调试器可能不会启动。

另请参阅