Freigeben über

Set-SCExternalJob

  • Referenz
Modul:
VirtualMachineManager

Aktualisierungen einem vorhandenen externen Auftrag.

Syntax

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

Beschreibung

Das Cmdlet Set-SCExternalJob aktualisiert vorhandene externe Aufträge im Virtual Machine Manager (VMM). Sie können den Prozentsatz des Abschlusses des Auftrags aktualisieren oder den Status des Auftrags auf abgeschlossen oder fehlgeschlagen festlegen.

Weitere Informationen zu externen Aufträgen finden Sie im Cmdlet New-SCExternalJob .

Beispiele

Beispiel 1: Festlegen eines externen Auftrags auf 15 % abgeschlossen

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

Der erste Befehl ruft das externe Auftragsobjekt mit dem Namen ExternalJob01 ab und speichert das Objekt in der $ExternalJob Variablen.

Der zweite Befehl legt den Statuswert für den Auftrag fest, der in $ExternalJob auf 15 gespeichert ist.

Beispiel 2: Festlegen eines externen Auftrags auf abgeschlossen

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

Der erste Befehl ruft das externe Auftragsobjekt mit dem Namen ExternalJob02 ab und speichert das Objekt in der $ExternalJob Variablen.

Der zweite Befehl legt den Status des in $ExternalJob gespeicherten Auftrags fest und fügt Informationen zum Auftrag hinzu.

Beispiel 3: Festlegen eines fehlgeschlagenen externen Auftrags

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

Der erste Befehl ruft das externe Auftragsobjekt mit dem Namen ExternalJob03 ab und speichert das Objekt in der variablen $ExternalJob.

Der zweite Befehl legt den Status des in $ExternalJob gespeicherten Auftrags fest und fügt Informationen zum Auftrag hinzu.

Parameter

-Completed

Legt den Status eines externen Auftrags fest, der abgeschlossen werden soll.

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

-Failed

Legt den Status eines externen Auftrags fest, der fehlgeschlagen ist.

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

-InfoMessage

Stellt eine Informationsmeldung für externe Aufträge bereit.

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

-Job

Gibt ein VMM-Auftragsobjekt an.

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

-ProgressValue

Liefert den Prozentsatz des Fortschritts eines externen Auftrags.

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

Ausgaben

Task

Dieses Cmdlet gibt ein Task-Objekt zurück.