作業取消
取消指定的執行中或暫止作業。
如需如何使用此指令的範例，請參閱 範例。
語法
job cancel <jobID> [/force] [/graceful] [/message:<message>] [/scheduler:<name>]
job cancel {/? | /help}
參數
| 參數 | 描述 |
|---|---|
| <jobID> | 指定您要取消之作業的識別碼。 |
| /力 | 如果作業包含此工作，則立即停止作業，而不使用工作取消的寬限期，而不需要執行節點釋放工作。 此參數是在Microsoft HPC Pack 2008 R2 中引進，舊版不支援此參數。 |
| /優美 | 讓執行中的工作完成，以正常方式停止工作。 此參數是在 HPC Pack 2012 R2 Update 1 中引進，而且舊版不支援。 |
| /message：<訊息> | 指定要提供給使用者的錯誤訊息，說明您取消作業的原因。 訊息的最大長度為 128 個字元。 |
| /scheduler：<名稱> | 指定您提交作業之叢集前端節點的主機名或IP位址。 此值必須是有效的計算機名稱或IP位址。 如果您未指定 /scheduler 參數，此命令會使用CCP_SCHEDULER環境變數所指定前端節點上的排程器。 |
| /? | 在命令提示字元中顯示說明。 |
| /help | 在命令提示字元中顯示說明。 |
備註
若要取消作業，作業的狀態必須是設定、提交、驗證、已排入佇列或執行中。
當您取消作業時，如果作業正在等候執行，HPC 作業排程器服務會從作業佇列中移除作業。
如果作業正在執行，HPC 作業排程器服務會停止執行的工作，並釋放其所使用的資源，以便配置給另一個作業。 HPC 作業排程器服務也會將執行中的工作狀態設定為 [失敗]。
如果您再次將作業排入佇列，則處理作業中工作的方式取決於您可以取消作業時的工作狀態。 取消作業時完成的工作會保持完成。 在執行之前明確取消的工作，且目前處於已取消狀態的工作會保持取消狀態。 所有其他工作都會排入佇列，包括失敗的工作。
當您使用 job cancel 命令取消作業時，作業的狀態會變更為 [已取消]。 從 HPC Pack 2008 R2 開始，您也可以呼叫 作業完成命令，將作業的狀態變更為已完成 命令。
範例
若要取消作業的作業標識碼為 45，並提供一則取消訊息，說明您取消作業以騰出空間讓不同的作業執行，請使用下列命令：
job cancel 45 /message:"Clearing space for job 51, which needs to run immediately."
若要立即取消作業標識碼為 469 的作業，而不使用工作取消的寬限期，而不執行節點發行工作，請使用下列命令：
job cancel 469 /force
若要取消作業標識碼為 12 正常運作，讓執行中的工作完成，請使用下列命令：
job cancel 12 /graceful