共用方式為


作業修改

設定指定作業的屬性。

如需如何使用此指令的範例,請參閱 範例

語法

job modify <jobID> {[/addexcludednodes:<node_list>] |   
[/clearexcludednodes] | [/removeexcludednodes:<node_list>]}   
[/askednodes:<node_list>] [/corespernode:<min>[-<max>]]   
[/customproperties:<property_list>]  
[/emailaddress:<address>] [/estimatedprocessmemory:<memory>]   
[/exclusive[:{true|false}]]   
[/faildependenttasks[:{true|false}]] [/failontaskfailure[:{true|false}]]   
[/holduntil:[{<DateTime>|<minutes>}]] [/jobenv:<variable_and_value_list> ]   
[/jobfile:<path>\<file_name>] [/jobname:<job_name>]   
[/jobtemplate:<job_template_name>] [/license:<license_list>]   
[/memorypernode:<min>[-<max>]] [/nodegroup:<node_group_list>]   
[/nodegroupop:{Intersect|Uniform|Union}]   
[/notifyoncompletion[:{true|false}]] [/notifyonstart[:{true|false}]]   
{[/numcores:<min>[-<max>]] | [/numnodes:<min>[-<max>]] |   
[/numprocessors:<min>[-<max>]] | [/numsockets:<min>[-<max>]] }   
[/orderby:<primary>[,<secondary>]] [/parentjobids:<jobID_list>]  
[/password:<password>] [/priority:<priority>]   
[/progress:<percent_progress>][/progressmsg:<message>]   
[/projectname:<name>] [/removeexcludednodes:nodename{,nodename}*]   
[/requestednodes:<node_list>] [/runtime:{<time>|Infinite}   
[/rununtilcanceled[:{true|false}]] [/scheduler:<name>]   
[/singlenode [:{true|false}]] [/taskexecutionfailureretrylimit:<retry_limit>]   
[/user:[<domain>\]<user_name>] [/validexitcodes {:int|intStart..intEnd}[,{int|intStart..intEnd}]*]   
  
job modify [{/? | /help}]  
  

參數

參數 描述
jobID 指定您要變更屬性之作業的作業標識碼。
/addexcludednodes:<node_list> 指定您想要新增至作業不應該以 <node1_name>[,<node2_name>...] 格式執行的節點名稱。

如果您在該節點上執行作業時,將節點新增至不應該用於作業的節點清單,則會取消節點上執行的工作,如果工作 IsRerunnable 屬性為 True,則會重新排入佇列。

如果在作業中任何工作 RequiredNodes 屬性中指定節點,如果您在 /addexcludednodes 參數中指定該節點,就會發生錯誤。

如果您在 /addexcludednodes 參數中指定一組節點,會導致可用資源集小於作業所需的最小資源數目,當您提交作業時就會發生例外狀況。 例如,如果您的 HPC 叢集是由三個節點所組成,而且您在 /addexcludednodes 參數中包含其中兩個節點,該動作只會讓一個節點可供使用,而且當您提交作業時,如果作業至少需要兩個節點,就會發生例外狀況。

如果您指定目前不屬於 HPC 叢集的節點名稱,就會發生錯誤。

如果您將相同的節點兩次新增至不應該用於作業的節點清單,則第二次新增節點沒有任何作用。

如果您同時指定 /clearexcludednodes/removeexcludednodes 參數,則無法 指定 /addexcludednodes 參數。 注意: 此參數是在 HPC Pack 2008 R2 中引進,舊版不支援。
/clearexcludednodes 從該清單中移除不應該用於作業之節點清單中的所有節點。

若要從不應該用於作業的節點清單中移除特定節點,請使用 /removeexcludednodes 參數。

如果您同時 指定 /addexcludednodes/removeexcludednodes 參數,則無法指定 /clearexcludednodes 參數。 注意: 此參數是在 HPC Pack 2008 R2 中引進,舊版不支援。
/removeexcludednodes:<node_list> 指定要從作業不應該以 <node1_name>[,<node2_name>...] 格式執行的節點清單中移除的節點名稱。

若要從該清單中移除不應該用於作業之節點上的所有節點,請使用 /clearexcludednodes 參數。

如果您指定目前不屬於 HPC 叢集的節點或屬於 HPC 叢集的節點,但不是不應該用於作業之目前節點清單的一部分,則 /removeexcludednodes 參數沒有任何作用,而且不會發生錯誤。

如果您同時指定 /addexcludednodes 或 /clearexcludednodes 參數,則您無法指定 /removeexcludednodes 參數。 注意: 此參數是在 HPC Pack 2008 R2 中引進,舊版不支援。
/askednodes:<node_list> 已取代。 請改用 /requestednodes 參數。
/corespernode:<分鐘>[-<max>] 指定節點可讓 HPC 作業排程器服務將節點視為執行作業的候選節點,可選擇性地指定節點數目上限和數目上限。 作業不會在節點上執行,其核心數目會比此參數指定的最大值少,或核心數還多。 如果叢集中的所有節點都有數個核心超出您為此參數指定的範圍,當您提交作業時就會發生錯誤。
/customproperties:<property_list> 以 <name1>=<value1>[;<name2>=<value2>...] 格式指定作業的自定義屬性名稱和值。自定義屬性名稱不區分大小寫,且會反映第一次定義時所使用的大小寫。 注意: 這個參數是在 HPC Pack 2012 中引進,舊版不支援。
/emailaddress:<位址> 傳送此作業的通知至此電子郵件位址。 注意: 這個參數是在 HPC Pack 2012 中引進,舊版不支援。
/estimatedprocessmemory:<記憶體> 此作業中每個進程估計耗用的記憶體數量上限,以 MB 為單位。
/exclusive[:{true|false}] 指定 HPC 作業排程器服務是否應該確保此作業執行時,不會在與這個作業相同的節點上執行其他作業。

True 值表示 HPC 作業排程器服務應該確保此作業執行時,不會在與此作業相同的節點上執行其他作業。

False 值表示此作業可以與其他作業共用計算節點。

當您指定不含值的 /exclusive 參數時,作業修改 命令的行為就如同您指定 True 的值一樣。 如果您未指定 /exclusive 參數,作業修改命令的行為就如同您指定了 False 值一樣。
/faildependenttasks[:{true|false}] 如果工作失敗或取消,則所有相依工作都會失敗。

如果未宣告 /faildependenttasks,則會假設為 True。 如果未宣告 /faildependenttasks,則會假設為 False。 注意: 這個參數是在 HPC Pack 2012 中引進,舊版不支援。
/failontahpailure[:{true|false}] 指定 HPC 作業排程器服務是否應該在作業失敗時立即停止作業,並立即失敗整個作業。

True 值表示 HPC 作業排程器服務應該停止作業,並在作業中的工作失敗時立即失敗整個作業。

False 值表示 HPC 作業排程器服務應該在作業中的任何工作失敗之後繼續執行作業中的其餘工作。

當您指定不含值的 /failontaailure 參數時,作業修改 命令的行為就如同您指定了 True 值一樣。 如果您未指定 /failonta 參數,作業修改 命令的行為就如同您指定了 False 值一樣。
/holduntil:[{<DateTime>|<分鐘>}] 指定本機時間的日期和時間,或 HPC 作業排程器服務在嘗試啟動作業之前應該等候的分鐘數。 如果未設定此參數,作業可以在資源可用時啟動。

HPC 作業排程器服務只會在此參數指定的日期和時間執行作業,以指定作業所需的資源是否可用。 如果該日期和時間無法使用作業所需的資源,作業會維持佇列,直到必要的資源可供使用為止。

您可以使用 .NET Framework 可剖析目前作業系統文化特性的任何格式來指定日期和時間。 如需 .NET Framework 如何剖析日期和時間字串串的資訊,請參閱 剖析日期和時間字串

只要作業未執行或完成,您就可以為作業指定 /holduntil 參數。 注意: 使用 /holduntil 指定的時間會在內部轉換為 UTC,而且不會反映本機日光節約時間。 如果使用分鐘值,它必須是整數。 套用作業修改 時,保留的分鐘數會轉換成 UTC。 如果 /holduntil 的值是空的,則會清除任何目前 /holduntil 值,而且作業不再因為該參數而擱置中。 注意: 這個參數是在 HPC Pack 2012 中引進,舊版不支援。
/jobenv:<variable_and_value_list> 指定要在作業運行時間環境中設定的環境變數,以及您要設定這些環境變數的值。 清單的格式應該是 <variable_name1>=<value1> [;<variable_name2>=<value2>...]。

或者,您可以藉由包含多個 /jobenv 參數來設定多個環境變數,每個變數都有 <variable_name>=<值>格式的不同自變數。

若要取消設定環境變數,請勿指定值。 例如,“<variable_to_unset_name>=”。

如果您為作業設定或取消設定環境變數,除非您使用 /env 參數來覆寫該工作的環境變數設定,否則該環境變數也會設定或取消設定作業中的每個工作。 注意: 此參數是在 HPC Pack 2008 R2 中引進,舊版不支援。
/jobfile:<路徑>\<file_name> 已取代。 請改用此命令的其他參數來變更作業的設定。
/jobname:<job_name> 指定要在命令輸出和使用者介面中用於此作業的名稱。

作業名稱的最大長度為80個字元。
/jobtemplate:<job_template_name> 指定要用於作業的作業範本名稱。

作業範本名稱的最大長度為80個字元。
/license:<license_list> 指定作業需要授權的功能清單,以及每個作業所需的授權數目。 使用 <license_name1>格式:<number1> [,<license_name2>:<number2>...] 此清單的 。 例如,License1:10,License2:20,License3:12。

清單的長度上限為 160 個字元。
/memorypernode:<min>[-<max>] 指定 HPC 作業排程器服務可以擁有的最小記憶體數量,以及選擇性地將節點視為執行作業的候選節點。 作業不會在記憶體小於最小值或記憶體大於此參數所指定最大值的節點上執行。 如果叢集中的所有節點都有超出您為此參數指定範圍的記憶體數量,當您提交作業時就會發生錯誤。
/nodegroup:<node_group_list> 指定此作業可以執行格式 <node_group1_name>為 [,<node_group2_name>...] 格式的節點群組清單。 HPC 作業排程器服務會根據預設,將資源從屬於清單中所有節點群組的節點配置給作業,或從群組清單中 /nodegroupop 參數作業所產生的節點配置資源。

如果您同時指定 /nodegroups/requestednodes 參數的值,則作業只會在 /requestednodes 參數之節點清單中的節點上執行,而該節點也屬於以 /nodegroupgroup/nodegroupop 參數定義的節點列表。

/nodegroup 參數可確保有效節點清單中有節點。 不過,如果無法從節點清單中符合上述參數的作業資源需求,作業在作業提交期間將會失敗。

如果您為工作指定參數 /requestednodes,且作業 /nodegroups,如果要求的節點未與 /nodegroup/nodegroupop 參數一起列出的節點,則作業會在提交期間失敗。
/nodegroupop:{Intersect|Uniform|Union} 指定 /nodegroup 參數所指定清單的運算符。 有效值為:

交集 - 建立所有列出的節點群組中的節點清單。

統一 - 讓 HPC 作業排程器服務依序嘗試節點群組。 如果第一個節點群組內有足夠的資源,則會使用它們。 如果沒有,排程器會嘗試下列每個節點群組,直到找到具有足夠資源的節點群組為止。 如果找不到足夠的資源,作業會維持佇列。

聯集 - 建立任何節點群組中的節點清單。

此參數的預設值為 Intersect。 注意: 這個參數是在 HPC Pack 2012 中引進,舊版不支援。
/notifyoncompletion[:{true|false}] 指定 HPC 作業排程器服務何時應該在作業結束時傳送電子郵件通知。

True 值表示 HPC 作業排程器服務應該在作業結束時傳送電子郵件通知。

False 值表示 HPC 作業排程器服務不應該在作業結束時傳送電子郵件通知。

當作業的狀態變更為 [已完成]、[失敗] 或 [已取消] 時,就會傳送作業結束和通知。

叢集管理員必須先設定 HPC 叢集的通知,才能收到有關作業的通知。

當您指定不含值的 /notifyoncompletion 參數時,作業 new 命令的行為就如同您指定了 True 值一樣。 如果您未指定 /notifyoncompletion 參數,作業 new 命令的行為就如同您指定了 False 值一樣。 注意: 此參數是在 HPC Pack 2008 R2 中引進,舊版不支援。
/notifyonstart[:{true|false}] 指定 HPC 作業排程器服務何時應該在作業啟動時傳送電子郵件通知。

True 值表示 HPC 作業排程器服務應該在作業啟動時傳送電子郵件通知。

False 值表示 HPC 作業排程器服務不應該在作業啟動時傳送電子郵件通知。

叢集管理員必須先設定 HPC 叢集的通知,才能收到有關作業的通知。

當您指定不含值的 /notifyonstart 參數時,作業 new 命令的行為就如同您指定了 True 值一樣。 如果您未指定 /notifyonstart 參數,作業 new 命令的行為就如同您指定了 False 值一樣。 注意: 此參數是在 HPC Pack 2008 R2 中引進,舊版不支援。
/numcores:<min>[-<max>] 指定作業在 HPC 叢集上所需的核心總數,<最低>[-<最大>]。 作業至少會在核心數目下限上執行,且不超過最大值。

如果您只指定一個值,此命令會將核心數目上限和最小值設定為該值。

如果您指定的最小值超過整個叢集可用的核心總數,當您提交作業時就會發生錯誤。

最小值和最大值只能是正整數或星號 。。 如果您將最小值或最大值指定為星號,HPC 作業排程器服務會根據作業中工作的最小和最大核心數目,自動計算運行時間的核心數目下限或上限。

如果您也指定 /numnodes/numprocessors/numsockets 參數,則您無法指定 /numcores 參數。
/numnodes:<min>[-<max>] 指定作業在 HPC 叢集上所需的節點總數,<最低>[-<最大>]。 作業至少會在節點數目下限上執行,且不超過最大值。

如果您只指定一個值,此命令會將節點數目上限和最小值設定為該值。

如果您指定超過叢集可用節點總數的最小值,當您提交作業時就會發生錯誤。

最小值和最大值只能是正整數或星號 。。 如果您將最小值或最大值指定為星號,HPC 作業排程器服務會根據作業中工作的節點數目下限和上限,自動計算運行時間的最小或最大節點數目。

如果您也指定 /numcores/numprocessors/numsockets 參數,則您無法指定 /numnodes 參數。
/numprocessors:<min>[-<max>] 已取代。 請改用 /numcores 參數。
/numsockets:<min>[-<max>] 指定作業在 HPC 叢集上所需的套接字總數,<最低>[-<最大>]。 作業至少會在套接字數目下限上執行,且不超過最大值。

如果您只指定一個值,此命令會將套接字數目上限和最小值設定為該值。

如果您指定的最小值超過整個叢集可用的套接字總數,當您提交作業時就會發生錯誤。

最小值和最大值只能是正整數或星號 。。 如果您將最小值或最大值指定為星號,HPC 作業排程器服務會根據作業中工作的套接字數目下限和上限,自動計算運行時間的套接字數目下限或上限。

如果您同時 指定 /numcores/numprocessors/numnodes 參數,則您無法指定 /numsockets 參數。
/orderby:<主要>[,<次要>] 指定 HPC 作業排程器服務應該使用 的順序,以 <primary_order>[,<secondary_order>] 格式將節點設定給作業。 值的primary_order和secondary_order部分可以是下列其中一個值:

-記憶
HPC 作業排程器服務會依可用的記憶體數量來排序節點,並先將作業配置給具有更多記憶體的節點。
- -memory
HPC 作業排程器服務會依可用的記憶體數量來排序節點,並將作業配置給記憶體較少的節點。
-核心
HPC 作業排程器服務會依可用的核心數目來排序節點,並先將作業配置給具有更多核心的節點。
-–核心
HPC 作業排程器服務會依可用的核心數目來排序節點,並先將作業配置給具有較少核心的節點。

當您指定次要順序時,HPC 作業排程器服務會先根據主要順序排序節點。 對於具有相同主要順序所指定資源數量的節點子集,HPC 作業排程器服務接著會使用次要排序順序來排序子集內的節點。 例如,如果您指定記憶體、核心,HPC 作業排程器服務會將節點從最高記憶體數量排序為最低。 然後,針對具有相同記憶體數量的節點子集,HPC 作業排程器服務會使用核心數目來中斷系結,並將具有相同記憶體數量的節點從最少的核心數目排序為最多。

主要順序和次要順序必須參考不同類型的資源。 例如,記憶體、核心是主要和次要排序順序的有效組合。 記憶體、記憶體和 -cores、-cores 等組合無效。

HPC 作業排程器服務用來將節點配置給作業的預設順序是核心、記憶體。
/password:<密碼> 指定作業應該在其中執行之帳戶的密碼。 如果您指定 /user 參數,但未指定 /password 參數,則 作業修改 命令會提示您輸入密碼,以及是否儲存密碼。
/parentjobids:<jobID_list> 指定作業將以 <jobID1>[,<jobID2>...] 的格式指定作業識別子清單。

作業標識碼必須已經存在。

HPC 作業排程器服務只有在其父工作已完成且全都處於已完成狀態時,才會排程作業。 如果任何父作業尚未完成或已完成,但處於已取消或失敗狀態,作業會維持佇列。 注意: 這個參數是在 HPC Pack 2012 中引進,舊版不支援。
/priority:<優先順序> 指定排程作業的優先順序。 針對 HPC Pack 2008,優先順序值只能是下列其中一個具名值:Highest、AboveNormal、Normal、BelowNormal 或 Lowest。

從 HPC Pack 2008 R2 開始,您可以使用您在 HPC Pack 2008 中使用的五個具名優先順序值中的任何一個。 您也可以使用介於 0 到 4000 之間的任何數位,0 作為最低優先順序,4000 為最高。 您也可以將優先權值指定為 named_value+位移named_value-位移。 為了達到這些最終格式的目的,具名優先順序具有下列值,且具名值和位移的組合不能小於0或大於4000。

最高-
4000

AboveNormal
- 3000

一般
- 2000

BelowNormal -
1000

最低
- 0

作業所使用的作業範本會指定影響誰可以指定提高優先順序的許可權。

HPC 作業排程器服務會依照使用者提交作業的順序,將具有相同優先權的工作放入作業佇列中,除非使用者重新排入作業佇列。 如果使用者重新排入工作佇列,HPC 作業排程器服務會將該作業放在具有相同優先權的作業中。

作業的預設優先順序為 Normal 或 2000。
/progress:<percent_progress> 指定完成之作業的百分比。 此值必須介於 0 到 100 之間。

如果您未設定這個屬性的值,HPC 作業排程器服務會根據作業完成的工作百分比計算進度。 當您為作業設定這個屬性時,HPC 作業排程器服務不會繼續更新此屬性,因此您必須繼續更新 屬性。 注意: 此參數是在 HPC Pack 2008 R2 中引進,舊版不支援。
/progressmsg:<訊息> 指定您要針對作業顯示的自訂狀態訊息。 此字串的最大長度為80個字元。

若要指定包含空格的狀態消息,請以引弧括住狀態消息()。 注意: 此參數是在 HPC Pack 2008 R2 中引進,舊版不支援。
/projectname:<名稱> 指定可用於追蹤作業之作業的項目名稱。

項目名稱的最大長度為80個字元。
/requestednodes:<node_list> 指定作業可以執行格式 <node1_name>為 [,<node2_name>...] 格式的節點名稱清單。 這些節點是作業的候選專案,但如果這些節點上的可用資源超過作業所需的資源,則並非所有節點都會執行作業。 HPC 作業排程器服務會根據 /orderby 參數的值來配置頂端節點,直到配置節點符合您使用 /numcores/numsockets/numprocessors/numnodes 參數所指定的值為止。

如果您未指定 /requestednodes 參數,HPC 作業排程器服務會將所有節點視為 HPC 作業排程器服務可配置給作業的候選專案。

如果您為 /requestednodes/nodegroups 參數指定值,則作業只會在 /requestednodes 參數的節點清單中執行,而該節點也屬於以 /nodegroupgroup/nodegroupop 参數定義的節點列表。
/runtime:{<time> |Infinite} 指定作業應該執行的時間上限。 在作業執行此時間之後,HPC 作業排程器服務會取消作業。 您可以使用 [[<天>:]<小時>:]<分鐘>的格式指定時間量。 您也可以指定 Infinite,指出作業可以無限時間執行。

如果您只指定 [[<天>:]<小時>:]<分鐘> 格式,命令會將指定的值解譯為分鐘數。 例如,12 表示 12 分鐘。

如果您指定格式的兩個部分,命令會將左邊部分解譯為小時,並將右邊部分解譯為分鐘數。 例如,10:30 表示 10 小時 30 分鐘。

您可以針對格式的每個部分使用一或多個數位。 每個元件的最大值為 2,147,483,647。 如果您未指定 /runtime 參數,預設值為 Infinite。
/rununtilcanceled[:{true|false}] 指定作業是否繼續執行並保留資源,直到運行時間限制到期或有人取消作業為止。

True 值表示作業會繼續執行並保留資源,直到運行時間限制到期或有人取消作業為止。 如果您指定 True 的值,則必須指定 /numcores/numnodes/numsockets 參數,或提交作業時發生錯誤。

False 值表示當作業中的所有工作都完成時,作業應該停止並釋放其資源。

當您指定不含值的 /rununtilcanceled 參數時,作業修改 命令的行為就像您指定了 True 的值一樣。 如果您未指定 /rununtilcanceled 參數,作業修改 命令的行為就如同您指定了 False 值一樣。
/scheduler:<名稱> 針對包含您要修改之作業的叢集,指定前端節點的主機名或IP位址。 此值必須是有效的計算機名稱或IP位址。 如果您未指定 /scheduler 參數,此命令會使用CCP_SCHEDULER環境變數所指定前端節點上的排程器。
/singlenode[:{true|false}] 指定所有資源都會配置在一個節點上。

如果 /singlenode 宣告為沒有值,則會假設為 True。 如果未宣告 /singlenode,則會假設 False。 注意: 這個參數是在 HPC Pack 2012 中引進,舊版不支援。
/taskexecutionfailureretrylimit:<retry_number> 指定此作業中工作在發生應用程式執行失敗之後,將會自動重新排入佇列的節點準備或節點發行工作以外的工作次數上限。 預設值為 0。 注意: HPC Pack 2012 R2 Update 1 中引進此參數。 在舊版中無法使用。
/user:[<網域>\]<user_name>] 指定使用者名稱,並選擇性地指定作業應該執行所在的帳戶網域。 如果您未指定此參數,作業會在用來提交作業的帳戶下執行。
/validexitcodes:{int|intStart..intEnd} [,{int|intStart..intEnd}]* 指定要用來檢查作業中工作是否順利結束的結束代碼。 /validexitcodes 必須由以逗號分隔的離散整數和整數範圍指定。

minmax 可用來作為整數範圍的開頭或結尾。 例如,0..max 代表所有非負整數。

宣告工作特定的 /validexitcodes /validexitcodes,即可覆寫此參數。 未明確宣告此參數的所有工作都會從作業繼承 參數。

如果未定義 /validexitcodes,則 0 是預設有效的結束代碼。 注意: 這個參數是在 HPC Pack 2012 中引進,舊版不支援。
/? 在命令提示字元中顯示說明。
/help 在命令提示字元中顯示說明。

備註

  • 您無法變更處於已完成狀態的作業屬性。

  • 針對處於執行中狀態的作業,您只能變更下列屬性:

    • 名稱

    • Project

    • 運行

    • RunUntilCanceled

    • 優先順序

    • AddExcludedNodes

    • ClearExcludedNodes

    • RemoveExcludedNodes

    • NotifyOnCompletion

    • 進展

    • ProgressMessage

    • JobEnv

  • 從 HPC Pack 2008 開始,您可以使用 作業修改 命令,將 runUntilCanceled 屬性 設定為 False,以結束要執行的作業。 如需如何結束其設定為在取消之前執行之作業的詳細資訊,請參閱 Windows HPC Server 2008 技術連結庫()的 作業一節中的。

    從 HPC Pack 2008 R2 開始,您可以使用 作業完成 命令,結束要執行的作業,直到取消作業為止。

範例

若要將作業標識碼為 47 的項目設定為叢集測試,請將作業的作業範本設定為 MyJobTemplate、作業的運行時間限製為 30 分鐘,並將作業的優先順序設定為 AboveNormal,請使用下列命令:

job modify 47 /jobtemplate:MyJobTemplate /projectname:"Cluster Testing" /runtime:0:0:30 /priority:AboveNormal  

若要指定具有 98 標識符的作業不應該在目前當地時間下午 10:00 之前開始執行,若要將作業的進度設定為 0,將作業的狀態消息設定為「保留」,並指定您要在作業完成時收到電子郵件通知, 使用下列命令:

job modify 98 /holduntil:"10:00 pm" /progress:0 /progressmsg:"on hold" /notifyoncompletion:true  

其他參考