Freigeben über


Restart-SCJob

Startet einen fehlgeschlagenen oder abgebrochenen VMM-Auftrag neu.

Syntax

Default (Standardwert)

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

Beschreibung

Mit dem Cmdlet Restart-SCJob werden ein oder mehrere Virtual Machine Manager (VMM)-Aufträge neu gestartet, bei denen ein Fehler aufgetreten ist oder die von einem Benutzer abgebrochen wurden. Jobs, 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 als funktionierend bekannten Prüfpunkt vor einem Fehler oder einem Abbruch (einige Aufträge haben nur einen einzigen Prüfpunkt).

Beim Neustart eines Auftrags werden dem Benutzer die Objekteigenschaften des Auftrags angezeigt, und die Statuseigenschaft wird ausgeführt.

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 Objekt des ausführenden Kontos mit dem Namen RunAsAccount01 ab und speichert das Objekt in der Variablen $Creds.

Der zweite Befehl ruft alle VMM-Aufträge aus der VMM-Datenbank ab, wählt nur Aufträge auf dem 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 ausführenden Konto 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 Objekt des ausführenden Kontos mit dem Namen RunAsAccount01 ab und speichert das Objekt in der Variablen $Creds.

Der zweite Befehl ruft das VMM-Auftragsobjekt mit der ID cb3a0f0a-9fbc-4bd0-a999-3fae8cd77177 ab und startet diesen Auftrag mit dem in $Creds angegebenen ausführenden Konto neu.

Parameter

-Credential

Gibt ein Objekt mit Anmeldeinformationen oder bei einigen Cmdlets ein ausführendes Kontoobjekt an, das den Benutzernamen und das Kennwort eines Kontos enthält, das über die Berechtigung zum Ausführen dieser Aktion verfügt. Oder, im Fall von Restart-SCJob, verfügt über die Berechtigung zum Abschließen einer neu gestarteten Aufgabe.

Geben Sie weitere Informationen zum PSCredential-Objekt ein Get-Help Get-Credential.

Weitere Informationen zu ausführenden Konten erhalten Sie, wenn Sie Get-Help New-SCRunAsAccounteingeben.

Parametereigenschaften

Typ:VMMCredential
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Job

Gibt ein VMM-Auftragsobjekt an.

Parametereigenschaften

Typ:Task
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:0
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-OnBehalfOfUser

Gibt einen Benutzernamen an. Dieses Cmdlet wird im Namen des Benutzers ausgeführt, der durch diesen Parameter angegeben wird.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-OnBehalfOfUserRole

Gibt eine Benutzerrolle an. Verwenden Sie zum Abrufen einer Benutzerrolle das Cmdlet Get-SCUserRole . Dieses Cmdlet wird im Namen der Benutzerrolle ausgeführt, die durch diesen Parameter angegeben wird.

Parametereigenschaften

Typ:UserRole
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-SkipLastFailedStep

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Ausgaben

Job

Dieses Cmdlet gibt ein Job-Objekt zurück.

Hinweise

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