Freigeben über

Restart-SCJob

  • Referenz
Modul:
VirtualMachineManager

Startet einen fehlgeschlagenen oder abgebrochenen VMM-Auftrag neu.

Syntax

Restart-SCJob
       [-Job] <Task>
       [-Credential <VMMCredential>]
       [-SkipLastFailedStep]
       [-OnBehalfOfUser <String>]
       [-OnBehalfOfUserRole <UserRole>]
       [<CommonParameters>]

Beschreibung

Das cmdlet Restart-SCJob cmdlet startet einen oder mehrere VMM-Aufträge (Virtual Machine Manager), die fehlgeschlagen sind oder die von einem Benutzer abgebrochen wurden. Aufträge, die derzeit ausgeführt werden, müssen abgebrochen werden, bevor sie neu gestartet werden können. Alle neu gestarteten Aufträge beginnen mit dem letzten bekannten guten Prüfpunkt, bevor ein Fehler oder ein Abbruch auftritt (einige Aufträge haben nur einen einzigen Prüfpunkt).

Beim Neustart eines Auftrags werden die Objekteigenschaften des Auftrags für den Benutzer angezeigt und die Status-Eigenschaft als Ausgeführt angezeigt.

Beispiele

Beispiel 1: Neustarten aller Aufträge, die auf einem bestimmten virtuellen Computer abgebrochen wurden

PS C:\> $Creds = Get-SCRunAsAccount -Name "RunAsAccount01"
PS C:\> Get-SCJob | where { $_.ResultName -eq "VM01" -and $_.Status -eq "Canceled" } | Restart-SCJob -Credential $Creds

Der erste Befehl ruft das Run As-Kontoobjekt mit dem Namen RunAsAccount01 ab und speichert das Objekt in der $Creds Variablen.

Der zweite Befehl ruft alle VMM-Aufträge aus der VMM-Datenbank ab, wählt nur Aufträge auf virtuellen Computer VM01 aus, die abgebrochen wurden, und übergibt dann jedes Objekt an das Cmdlet Restart-SCJob, das die Aufträge mit dem in $Creds angegebenen Konto "Ausführen als" neu startet.

Beispiel 2: Neustarten eines bestimmten Auftrags

PS C:\> $Creds = Get-SCRunAsAccount -Name "RunAsAccount01"
PS C:\> Get-SCJob -ID "cb3a0f0a-9fbc-4bd0-a999-3fae8cd77177" | Restart-SCJob -Credential $Creds

Der erste Befehl ruft das Run As-Kontoobjekt mit dem Namen RunAsAccount01 ab und speichert das Objekt in der $Creds Variablen.

Der zweite Befehl ruft das VMM-Auftragsobjekt mit der ID cb3a0f0a-9fbc-4bd0-a999-3fae8cd77177 ab und startet diesen Auftrag mithilfe des in $Creds bereitgestellten Run As-Kontos neu.

Parameter

-Credential

Gibt ein Anmeldeinformationsobjekt oder für einige Cmdlets ein Run As-Kontoobjekt an, das den Benutzernamen und das Kennwort eines Kontos enthält, das über die Berechtigung zum Ausführen dieser Aktion verfügt. Oder hat im Falle von Restart-SCJob-die Berechtigung, eine neu gestartete Aufgabe abzuschließen.

Wenn Sie weitere Informationen zum PSCredential--Objekt erhalten möchten, geben Sie Get-Help Get-Credentialein.

Wenn Sie weitere Informationen zu "Als Konten ausführen" wünschen, geben Sie Get-Help New-SCRunAsAccountein.

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

-Job

Gibt ein VMM-Auftragsobjekt an.

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

-OnBehalfOfUser

Gibt einen Benutzernamen an. Dieses Cmdlet wird im Auftrag des Benutzers ausgeführt, den dieser Parameter angibt.

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

-OnBehalfOfUserRole

Gibt eine Benutzerrolle an. Verwenden Sie zum Abrufen einer Benutzerrolle das cmdlet Get-SCUserRole. Dieses Cmdlet wird im Auftrag der Benutzerrolle ausgeführt, die dieser Parameter angibt.

Typ:UserRole
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SkipLastFailedStep

Gibt an, dass der letzte Fehlgeschlagene Schritt nicht erneut ausgeführt wird, wenn ein Auftrag neu gestartet wird.

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

Ausgaben

Job

Dieses Cmdlet gibt ein Job-Objekt zurück.

Hinweise

  • Für dieses Cmdlet ist ein VMM-Auftragsobjekt erforderlich, das mithilfe des cmdlets Get-SCJob abgerufen werden kann.