Delen via

Set-SCExternalJob

  • Referentie
Module:
VirtualMachineManager

Hiermee werkt u een bestaande externe taak bij.

Syntaxis

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

Description

De Set-SCExternalJob cmdlet werkt bestaande externe taken bij in Virtual Machine Manager (VMM). U kunt het percentage voltooid van de taak bijwerken of de status van de taak instellen op voltooid of mislukt.

Zie de cmdlet New-SCExternalJob voor meer informatie over externe taken.

Voorbeelden

Voorbeeld 1: Een externe taak instellen op 15% voltooid

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

Met de eerste opdracht wordt het externe taakobject met de naam ExternalJob01 opgehaald en wordt het object opgeslagen in de $ExternalJob variabele.

Met de tweede opdracht wordt de voortgangswaarde voor de taak die is opgeslagen in $ExternalJob ingesteld op 15.

Voorbeeld 2: Een externe taak instellen op voltooid

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

Met de eerste opdracht wordt het externe taakobject met de naam ExternalJob02 opgehaald en wordt het object opgeslagen in de $ExternalJob variabele.

Met de tweede opdracht wordt de status van de taak die is opgeslagen in $ExternalJob ingesteld op voltooid en wordt informatie over de taak toegevoegd.

Voorbeeld 3: Een externe taak instellen op mislukt

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

Met de eerste opdracht wordt het externe taakobject met de naam ExternalJob03 opgehaald en wordt het object opgeslagen in de $ExternalJob variabele.

Met de tweede opdracht wordt de status van de taak die is opgeslagen in $ExternalJob mislukt, ingesteld en wordt informatie over de taak toegevoegd.

Parameters

-Completed

Hiermee stelt u de status van een externe taak in op voltooid.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Failed

Hiermee stelt u de status van een externe taak in op mislukt.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-InfoMessage

Biedt een informatief bericht voor externe taken.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Job

Hiermee geeft u een VMM-taakobject op.

Type:Task
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ProgressValue

Levert het percentage voltooid van de voortgang van een externe taak.

Type:Int32
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Uitvoerwaarden

Task

Deze cmdlet retourneert een Task-object.