Delen via

Set-SCExternalJob

  • Referentie
Module:
VirtualMachineManager

Updates een bestaande externe taak.

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

Met de cmdlet Set-SCExternalJob worden bestaande externe taken in Virtual Machine Manager (VMM) bijgewerkt. U kunt het percentage voltooide 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 ingesteld voor de taak die is opgeslagen in $ExternalJob tot 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 variabele $ExternalJob.

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 ingesteld van de taak die is opgeslagen in $ExternalJob mislukt 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
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Failed

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

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

-InfoMessage

Bevat een informatief bericht voor externe taken.

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

-Job

Hiermee geeft u een VMM-taakobject op.

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

-ProgressValue

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

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

Uitvoerwaarden

Task

Deze cmdlet retourneert een taakobject .