取消指定的任务或子任务以及与任务或子任务关联的所有资源预留。
有关如何使用此命令的示例,请参阅 示例。
语法
task cancel <jobID>.<taskID>[.<subtaskID>] [/force] [/message:<message>]
[/scheduler:<name>]
task cancel {/? | /help}
参数
| 参数 | DESCRIPTION |
|---|---|
| <jobID>。<taskID>[.<subtaskID>] | 指定要取消的任务或子任务。 只有参数任务具有子任务。 对于参数任务,可以取消子任务或整个任务。 |
| /力 | 在不对任务取消使用宽限期的情况下立即停止任务。 只有当用户键入 CTRL+BREAK 时做出响应的任务才能使用任务取消的宽限期。 注意: 此参数在Microsoft HPC Pack 2008 R2 中引入,在以前的版本中不受支持。 |
| /message:<message> | 指定要添加到任务日志的消息,以解释取消任务的原因。 如果消息包含空格,请将消息括在双引号 (“ ) 中。 |
| /scheduler:<name> | 为提交任务或子任务的群集指定头节点的主机名或 IP 地址。 该值必须是有效的计算机名称或 IP 地址。 如果未指定 /scheduler 参数,此命令将在CCP_SCHEDULER环境变量指定的头节点上使用计划程序。 |
| /? | 在命令提示符下显示帮助。 |
| /帮助 | 在命令提示符下显示帮助。 |
注解
只有任务的管理员或所有者才能取消该任务。
取消任务或子任务时,如果任务或子任务正在等待运行,作业计划程序将从队列中删除任务或子任务。 如果任务或子任务正在运行,作业计划程序将停止任务或子任务,并释放用于分配给作业中的其他任务的资源。 如果作业中不包含要取消的任务的其他任务需要资源,则作业计划程序会将资源分配给其他作业。
例子
若要取消作业中具有 45 个作业标识符的第一个任务,请使用以下命令:
task cancel 45.1
若要取消作业中具有 67 个作业标识符的第 50 个子任务或参数任务的步骤,并提供一条消息,说明取消子任务的原因,请使用以下命令:
task cancel 67.3.50 /message:"The fiftieth step is unnecessary."
若要立即取消作业中第三个任务,且作业标识符为 94,而不对任务取消使用宽限期,请使用以下命令:
task cancel 94.3 /force