適用於:Configuration Manager (目前的分支)
工作順序偵錯工具是一種疑難排解工具。 您在偵錯模式下將任務順序部署到小型集合。 它可讓您以受控的方式逐步執行工作順序,以協助疑難排解和調查。 偵錯工具目前與工作順序引擎執行於相同的裝置上,它不是遠端偵錯工具。
提示
此功能最初是在版本 1906 中作為 發行前功能推出。 從版本 2203 開始,它不再是發行前版本功能。
Configuration Manager 預設不會啟用此選擇性功能。 使用之前,您必須先啟用此功能。 如需詳細資訊,請參閱 從更新啟用選用功能。
必要條件
更新目標裝置上的 Configuration Manager 用戶端
以本機 Administrators 群組中的使用者身分登入目標裝置。 偵錯工具僅針對系統管理員執行。
更新與工作順序相關聯的開機映像,以確保它具有最新的用戶端版本
啟動工具
在 Configuration Manager 主控台中,移至 [軟體庫] 工作區,展開 [作業系統],然後選取 [工作順序]。
選取工作順序。 在功能區的 [部署] 群組中,選取 [偵錯]。
提示
或者,在部署工作順序的集合或電腦物件上,將變數 TSDebugMode 設定
TRUE。 任何設定此變數的裝置,都會將部署到它的任何工作順序置於偵錯模式。建立偵錯部署。 部署設定與一般工作順序部署相同。 如需詳細資訊,請參閱部署 工作順序。
注意事項
您只能選取一小部分集合進行偵錯部署。 它只會顯示具有 10 個或更少成員的裝置集合。
使用工作順序變數 TSDebugOnError ,在工作順序傳回錯誤時自動啟動偵錯工具。 如需詳細資訊,請參閱 工作順序變數 - TSDebugOnError。
使用工具
當工作順序在裝置上執行時,隨即開啟 [任務序列偵錯工具] 視窗,類似下列螢幕擷取畫面:
偵錯工具包含下列控制項:
步驟:從 目前 位置開始,只執行工作順序中的下一個步驟。
注意事項
當工作順序處於偵錯模式時,如果步驟傳回嚴重錯誤,工作順序不會正常失敗。 此行為可讓您選擇在進行外部變更後重試步驟。
執行:從 目前 位置開始,正常執行工作順序直到結束、下一個 中斷 點或步驟失敗。 使用此動作之前,請務必使用 [設定中斷 ] 動作設定任何中斷點。
設定目前:在偵錯工具中選取步驟,然後選取 [ 設定目前]。 此動作會將 目前 指標移至該步驟。 此動作可讓您略過步驟或向後移動。
警告
當您變更序列中的目前位置時,偵錯工具不會考慮步驟類型。 某些步驟可能會設定稍後步驟條件評估所需的工作順序變數。 如果出現故障,某些步驟可能會失敗或對裝置造成嚴重損壞。 請自行承擔使用此選項的風險。
設定休息時間:在偵錯工具中選取步驟,然後選取 [設定休息時間]。 此動作會在偵錯工具中新增 中斷 點。 當您 執行 工作順序時,它會在 休息時停止。
在使用 [執行 ] 動作之前,請先設定中斷點。
如果您在偵錯工具中建立中斷點,然後工作順序重新啟動電腦,偵錯工具會在重新啟動後保留您的中斷點。
清除所有中斷符號:移除所有中斷點。
記錄檔: 使用 CMTrace 開啟目前的工作順序記錄檔 smsts.log。 當工作順序引擎「正在等候偵錯工具」時,您可以看到記錄項目。
Cmd 提示字元:在 Windows PE 中,開啟命令提示字元。
取消:關閉偵錯工具,並使工作順序失敗。
結束:中斷連結並關閉偵錯工具,但工作順序會繼續正常執行。
[ 工作順序變數] 視窗顯示工作順序環境中所有變數的目前值。 如需詳細資訊,請參閱 工作順序變數。 如果您使用 [設定工作序列變數 ] 步驟搭配 [ 不顯示此值] 選項,偵錯工具就不會顯示變數值。 您無法在偵錯工具中編輯變數值。
注意事項
某些工作順序變數僅供內部使用,未列在參考文件中。
工作順序偵錯工具會在 [重新啟動電腦] 步驟之後繼續執行。 偵錯工具會在重新啟動後保留您的中斷點。 即使工作順序可能不需要它,但因為偵錯工具需要使用者互動,所以您需要登入 Windows 才能繼續。 如果您在一小時後未登入以繼續偵錯,工作順序會失敗。
它也會使用 [執行工作順序 ] 步驟逐步執行子工作順序。 偵錯工具視窗會顯示子工作順序的步驟以及主要工作順序。
已知問題
如果您透過多個部署將正常部署和偵錯部署同時鎖定在同一個裝置,則工作順序偵錯工具可能無法啟動。