Dela via


Set-SCExternalJob

Uppdateringar 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 % klart

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 att 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 till misslyckad och lägger till information om jobbet.

Parametrar

-Completed

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

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

-Failed

Anger statusen för ett externt jobb till misslyckad.

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

-InfoMessage

Innehåller ett informationsmeddelande för externa jobb.

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

-Job

Anger ett VMM-jobbobjekt.

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

-ProgressValue

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

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

Utdata

Task

Den här cmdleten returnerar ett aktivitetsobjekt .