调试任务序列

  • 项目

适用于: Configuration Manager(current branch)

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

提示

此功能最初在版本 1906 中作为 预发布功能引入。 从版本 2203 开始，它不再是预发行功能。

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

先决条件

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

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

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

启动工具

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

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

    提示

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

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

    注意

    只能为调试部署选择小型集合。 它仅显示具有 10 个或更少成员的设备集合。

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

使用工具

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

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

调试器包括以下控件：

  • 步骤：从 当前位置 ，仅运行任务序列中的下一步。

    注意

    当任务序列处于调试模式时，如果步骤返回严重错误，任务序列不会正常失败。 通过此行为，可以选择在进行外部更改后重试步骤。

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

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

    警告

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

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

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

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

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

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

  • Cmd 提示符：在 Windows PE 中，打开命令提示符。

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

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

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

注意

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

任务序列调试器在 重启计算机 步骤后继续运行。 调试器在重启后保留断点。 即使任务序列可能不需要它，因为调试器需要用户交互，所以你需要登录到 Windows 才能继续。 如果一小时后未登录以继续调试，任务序列将失败。

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

已知问题

如果通过多个部署将常规部署和调试部署都定位到同一设备，任务序列调试器可能无法启动。

另请参阅