Dela via


Set-SCExternalJob

Uppdaterar ett befintligt externt jobb.

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

Cmdleten Set-SCExternalJob uppdaterar befintliga externa jobb i Virtual Machine Manager (VMM). Du kan uppdatera procent färdigt för jobbet eller ange status för jobbet som slutfört eller misslyckat.

Mer information om externa jobb finns i cmdleten New-SCExternalJob.

Exempel

Exempel 1: Ange ett externt jobb till 15% slutfört

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

Det första kommandot hämtar det externa jobbobjektet med namnet ExternalJob01 och lagrar objektet i variabeln $ExternalJob.

Det andra kommandot anger förloppsvärdet för jobbet som lagras i $ExternalJob till 15.

Exempel 2: Ange att ett externt jobb ska slutföras

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

Det första kommandot hämtar det externa jobbobjektet med namnet ExternalJob02 och lagrar objektet i variabeln $ExternalJob.

Det andra kommandot anger status för jobbet som lagras i $ExternalJob som ska slutföras och lägger till information om jobbet.

Exempel 3: Ange att ett externt jobb ska misslyckas

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

Det första kommandot hämtar det externa jobbobjektet med namnet ExternalJob03 och lagrar objektet i variabeln $ExternalJob.

Det andra kommandot anger statusen för jobbet som lagras i $ExternalJob misslyckades och lägger till information om jobbet.

Parametrar

-Completed

Anger status för ett externt jobb som slutfört.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Failed

Anger statusen för ett externt jobb som misslyckades.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-InfoMessage

Innehåller ett informationsmeddelande för externa jobb.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Job

Anger ett VMM-jobbobjekt.

Typ:Task
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ProgressValue

Tillhandahåller procent färdigt för förloppet för ett externt jobb.

Typ:Int32
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Utdata

Task

Den här cmdleten returnerar ett task-objekt.