Freigeben über

Set-SCExternalJob

  • Referenz
Modul:
VirtualMachineManager

Aktualisiert einen 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 Set-SCExternalJob Cmdlet aktualisiert vorhandene externe Aufträge im Virtual Machine Manager (VMM). Sie können den Prozentsatz der Fertigstellung 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 in $ExternalJob gespeicherten Auftrag auf 15 fest.

Beispiel 2: Festlegen eines abgeschlossenen externen Auftrags

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 variablen $ExternalJob.

Mit dem zweiten Befehl wird der Status des in $ExternalJob gespeicherten Auftrags auf abgeschlossen festgelegt und Informationen zum Auftrag hinzugefügt.

Beispiel 3: Festlegen eines externen Auftrags auf fehlgeschlagen

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 $ExternalJob Variablen.

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

Parameter

-Completed

Legt den Status eines externen Auftrags auf abgeschlossen fest.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Failed

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InfoMessage

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Job

Gibt ein VMM-Auftragsobjekt an.

Typ:Task
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ProgressValue

Liefert den Prozentsatz der Fertigstellung des Fortschritts eines externen Auftrags.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Ausgaben

Task

Dieses Cmdlet gibt ein Task-Objekt zurück.