通过

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

设置要完成的外部作业的状态。

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Failed

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

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InfoMessage

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Job

指定一个 VMM 作业对象。

Type:Task
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ProgressValue

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

Type:Int32
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

输出

Task

此 cmdlet 返回 Task 对象。