共用方式為

Set-SCExternalJob

  • 參考
模組:
VirtualMachineManager

更新現有的外部作業。

Syntax

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

Description

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 物件。