Set-SCExternalJob

語法

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

-Failed

-InfoMessage

-Job

-ProgressValue

輸出

Task

此 Cmdlet 會傳回 Task 物件。

相關連結

• New-SCExternalJob