Set-SCExternalJob

模块:

VirtualMachineManager

更新现有外部作业。

语法

Set-SCExternalJob
   [-Job] <Task>
   -ProgressValue <Int32>
   [<CommonParameters>]

Set-SCExternalJob
   [-Job] <Task>
   [-Completed]
   [-InfoMessage <String>]
   [<CommonParameters>]

Set-SCExternalJob
   [-Job] <Task>
   [-Failed]
   -InfoMessage <String>
   [<CommonParameters>]

说明

Set-SCExternalJob cmdlet 更新 Virtual Machine Manager（VMM）中的现有外部作业。 可以更新作业完成百分比，或将作业的状态设置为已完成或失败。

有关外部作业的详细信息，请参阅 New-SCExternalJob cmdlet。

示例

示例 1：将外部作业设置为 15% 完成

PS C:\> $ExternalJob = Get-SCJob -Name "ExternalJob01"
PS C:\> Set-SCExternalJob -Job $ExternalJob -ProgressValue 15

第一个命令获取名为 ExternalJob01 的外部作业对象，并将该对象存储在$ExternalJob变量中。

第二个命令将存储在 $ExternalJob 中的作业的进度值设置为 15。

示例 2：将外部作业设置为已完成

PS C:\> $ExternalJob = Get-SCJob -Name "ExternalJob02"
PS C:\> Set-SCExternalJob -Job $ExternalJob -Completed -InfoMessage "Some information about the completed job"

第一个命令获取名为 ExternalJob02 的外部作业对象，并将该对象存储在$ExternalJob变量中。

第二个命令将存储在$ExternalJob中的作业的状态设置为已完成，并添加有关作业的信息。

示例 3：将外部作业设置为失败

PS C:\> $ExternalJob = Get-SCJob -Name "ExternalJob03"
PS C:\> Set-SCExternalJob -Job $ExternalJob -Failed -InfoMessage "An error message for the failed job"

第一个命令获取名为 ExternalJob03 的外部作业对象，并将该对象存储在$ExternalJob变量中。

第二个命令将存储在$ExternalJob中的作业的状态设置为失败，并添加有关作业的信息。

参数

-Completed

将外部作业的状态设置为已完成。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-Failed

将外部作业的状态设置为失败。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-InfoMessage

为外部作业提供信息性消息。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-Job

指定 VMM 作业对象。

类型:	Task
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-ProgressValue

提供外部作业进度完成百分比。

类型:	Int32
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

输出

Task

此 cmdlet 返回 Task 对象。

相关链接

• New-SCExternalJob