Freigeben über

Stop-SCJob

  • Referenz
Modul:
VirtualMachineManager

Beendet die Ausführung von VMM-Aufträgen.

Syntax

Stop-SCJob
    [-Job] <Task>
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

Beschreibung

Das cmdlet Stop-SCJob beendet einen oder mehrere VMM-Aufträge (Virtual Machine Manager), die ausgeführt werden, und gibt das Objekt für jeden Auftrag in einem angehaltenen Zustand zurück. Wenn der VMM-Auftrag derzeit nicht ausgeführt wird, hat dieses Cmdlet keine Auswirkung.

Beispiele

Beispiel 1: Beenden aller derzeit ausgeführten Aufträge

PS C:\> $Job = Get-SCJob | where { $_.Status -eq "Running" }
PS C:\> $Job | Stop-SCJob

Der erste Befehl ruft alle VMM-Auftragsobjekte ab, übergibt jedes Auftragsobjekt an den Filter "where", um nur die derzeit ausgeführten Aufträge auszuwählen, und speichert die Objekte im $Job Objektarray.

Der zweite Befehl übergibt jedes Objekt in $Job an das cmdlet Stop-SCJob, das jeden ausgeführten Auftrag beendet.

Beispiel 2: Asynchrones Beenden eines bestimmten ausgeführten Auftrags

PS C:\> $Job = Get-SCJob | where { $_.ResultName -eq "VM01" -and $_.ID -eq "cb3a0f0a-9fbc-4bd0-a999-3fae8cd77177" }
PS C:\> Stop-SCJob -Job $Job

Der erste Befehl ruft alle VMM-Auftragsobjekte ab und wählt aus den Ergebnissen nur den Auftrag auf VM01 aus, der durch die Auftrags-ID cb3a0f0a-9fbc-4bd0-a999-3fae8cd77177 identifiziert wird, und speichert dann das objekt in der $Job Variable.

Der zweite Befehl beendet den Auftrag und gibt das angehaltene Auftragsobjekt an den Benutzer zurück.

Parameter

-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

Ausgaben

Task

Dieses Cmdlet gibt ein Task-Objekt zurück.

Hinweise

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