針對工作順序進行偵錯

適用於:Configuration Manager (目前的分支)

工作順序偵錯工具是一種疑難排解工具。 您在偵錯模式下將任務順序部署到小型集合。 它可讓您以受控的方式逐步執行工作順序,以協助疑難排解和調查。 偵錯工具目前與工作順序引擎執行於相同的裝置上,它不是遠端偵錯工具。

提示

此功能最初是在版本 1906 中作為 發行前功能推出。 從版本 2203 開始,它不再是發行前版本功能。

Configuration Manager 預設不會啟用此選擇性功能。 使用之前,您必須先啟用此功能。 如需詳細資訊,請參閱 從更新啟用選用功能。

必要條件

  • 更新目標裝置上的 Configuration Manager 用戶端

  • 以本機 Administrators 群組中的使用者身分登入目標裝置。 偵錯工具僅針對系統管理員執行。

  • 更新與工作順序相關聯的開機映像,以確保它具有最新的用戶端版本

啟動工具

  1. 在 Configuration Manager 主控台中,移至 [軟體庫] 工作區,展開 [作業系統],然後選取 [工作順序]。

  2. 選取工作順序。 在功能區的 [部署] 群組中,選取 [偵錯]。

    提示

    或者,在部署工作順序的集合或電腦物件上,將變數 TSDebugMode 設定 TRUE 。 任何設定此變數的裝置,都會將部署到它的任何工作順序置於偵錯模式。

  3. 建立偵錯部署。 部署設定與一般工作順序部署相同。 如需詳細資訊,請參閱部署 工作順序。

    注意事項

    您只能選取一小部分集合進行偵錯部署。 它只會顯示具有 10 個或更少成員的裝置集合。

使用工作順序變數 TSDebugOnError ,在工作順序傳回錯誤時自動啟動偵錯工具。 如需詳細資訊,請參閱 工作順序變數 - TSDebugOnError。

使用工具

當工作順序在裝置上執行時,隨即開啟 [任務序列偵錯工具] 視窗,類似下列螢幕擷取畫面:

任務序列偵錯工具的螢幕擷取畫面。

偵錯工具包含下列控制項:

  • 步驟:從 目前 位置開始,只執行工作順序中的下一個步驟。

    注意事項

    當工作順序處於偵錯模式時,如果步驟傳回嚴重錯誤,工作順序不會正常失敗。 此行為可讓您選擇在進行外部變更後重試步驟。

  • 執行:從 目前 位置開始,正常執行工作順序直到結束、下一個 中斷 點或步驟失敗。 使用此動作之前,請務必使用 [設定中斷 ] 動作設定任何中斷點。

  • 設定目前:在偵錯工具中選取步驟,然後選取 [ 設定目前]。 此動作會將 目前 指標移至該步驟。 此動作可讓您略過步驟或向後移動。

    警告

    當您變更序列中的目前位置時,偵錯工具不會考慮步驟類型。 某些步驟可能會設定稍後步驟條件評估所需的工作順序變數。 如果出現故障,某些步驟可能會失敗或對裝置造成嚴重損壞。 請自行承擔使用此選項的風險。

  • 設定休息時間:在偵錯工具中選取步驟,然後選取 [設定休息時間]。 此動作會在偵錯工具中新增 中斷 點。 當您 執行 工作順序時,它會在 休息時停止。

    • 在使用 [執行 ] 動作之前,請先設定中斷點。

    • 如果您在偵錯工具中建立中斷點,然後工作順序重新啟動電腦,偵錯工具會在重新啟動後保留您的中斷點。

  • 清除所有中斷符號:移除所有中斷點。

  • 記錄檔: 使用 CMTrace 開啟目前的工作順序記錄檔 smsts.log。 當工作順序引擎「正在等候偵錯工具」時,您可以看到記錄項目。

  • Cmd 提示字元:在 Windows PE 中,開啟命令提示字元。

  • 取消:關閉偵錯工具,並使工作順序失敗。

  • 結束:中斷連結並關閉偵錯工具,但工作順序會繼續正常執行。

[ 工作順序變數] 視窗顯示工作順序環境中所有變數的目前值。 如需詳細資訊,請參閱 工作順序變數。 如果您使用 [設定工作序列變數 ] 步驟搭配 [ 不顯示此值] 選項,偵錯工具就不會顯示變數值。 您無法在偵錯工具中編輯變數值。

注意事項

某些工作順序變數僅供內部使用,未列在參考文件中。

工作順序偵錯工具會在 [重新啟動電腦] 步驟之後繼續執行。 偵錯工具會在重新啟動後保留您的中斷點。 即使工作順序可能不需要它,但因為偵錯工具需要使用者互動,所以您需要登入 Windows 才能繼續。 如果您在一小時後未登入以繼續偵錯,工作順序會失敗。

它也會使用 [執行工作順序 ] 步驟逐步執行子工作順序。 偵錯工具視窗會顯示子工作順序的步驟以及主要工作順序。

已知問題

如果您透過多個部署將正常部署和偵錯部署同時鎖定在同一個裝置,則工作順序偵錯工具可能無法啟動。

另請參閱