發佈設定
0 min
使用發佈 > 設定頁面可設定應用程式傳回代碼對應。 可執行檔與指令碼套件動作可能會在結束時傳回正或負的數字代碼,以指示各種結果。 這些傳回代碼會影響應用程式狀態並決定動作是成功、失敗或需要重新開機。
使用自訂傳回代碼對應可自訂 EXE、MSI 和指令碼動作的結果。 例如,Microsoft 的 Robocopy 公用程式有多個指示成功的傳回代碼。 在預設情況下,非零可執行檔傳回代碼表示失敗。 您可以為 Robocopy 建立自訂傳回代碼對應,將這些非零傳回代碼對應為成功,以允許套件處理繼續進行。
傳回代碼會作為每個發佈的一部分保存在裝置上的記錄中。 有關記錄及其存取方式的詳細資訊,請參閱偵測規則與動作記錄。
除了將數字傳回代碼保存在記錄中之外,您還可以將這些傳回代碼對應至資訊字串。 這些描述傳回代碼的字串也將顯示在記錄中。
有三種傳回代碼範本:
- 您建立的新範本。
- 現有範本的複製副本。 若要複製現有範本,請使用該範本右側的選項功能表 (
)。
- 您無法編輯或刪除的預設範本,只能將一個範本標示為預設範本。 您可以編輯複製副本。
這些是預設傳回代碼範本。 這些範本中未對應之傳回代碼的預設行為是失敗。
- 系統範本 - 預設 MSI: 包含標準化的 MSI 傳回代碼集。 這些是為您預先設定的代碼。
- 系統範本 - 預設 EXE: 包含數字零 (表示成功) 的一個傳回代碼對應。
- 系統範本 - 預設 PowerShell: 包含兩個傳回代碼對應。 數字零表示成功,而數字一表示失敗。
您可以將範本類型 MSI、EXE 與 PowerShell 的其中一種標示為預設範本。 傳回代碼對應清單有一個欄,顯示哪些範本為預設範本。 若要變更預設值,請編輯範本並選取該選項。
當您建立支援傳回代碼範本的套件動作時,會為您預先選取預設值。 如果您不想使用預設值,可以針對該動作類型選取其他範本。 您所做的範本變更會在下次發佈引擎在用戶端上執行時生效。
MSI 傳回代碼範本包含 3010「成功 - 需要重新開機」的傳回代碼對應。 此結果與「成功」相同,但在該發佈的裝置記錄中註明,其需要在某個時間點重新開機。 套件的部署狀態也會顯示「成功 (需要重新開機)」。
建立或編輯傳回代碼範本
- 選取新建以及您想要的範本類型,或選取現有範本。 預先設定的系統範本為唯讀。
- 輸入範本名稱和說明。
- 如果您希望此範本成為您所選範本類型 (例如 EXE 或 PowerShell) 的預設範本,在將此設為預設範本下方,選取 True。
- 針對未對應的傳回代碼,選取預設結果。 預設值為失敗。 您選取的結果是從傳回代碼清單中未列出之動作返回的任何傳回代碼將會發生的結果。 例如,如果您選擇失敗 (建議),不在清單中的所有傳回代碼都會導致動作以失敗結果返回。 如果您選擇成功,其他所有傳回代碼都將以成功結果返回。
- 指定會針對您所選預設未對應之傳回代碼結果顯示的預設訊息文字。
- 選取 + 新增傳回代碼。
- 輸入整數格式 (無小數) 的傳回代碼數字或數字範圍、結果 (失敗或成功),以及您要與傳回代碼一起記錄的訊息文字。 若要輸入數字範圍,請用兩個句點分隔數字,例如 15..30。
- 選取保存。
- 針對您需要的每個傳回代碼,重複步驟 7 與 8。
- 完成後,關閉新增對應面板並選取保存。
