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 beendeten 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 die Objekte im $Job-Objektarray zu speichern.

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

Beispiel 2: Beenden eines bestimmten Ausführungsauftrags asynchron

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-a99-3fae8cd7177 identifiziert wird, und speichert dann das thie-Objekt in der $Job Variable.

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

Parameter

-Job

Gibt ein VMM-Auftragsobjekt an.

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

-OnBehalfOfUser

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

Ausgaben

Task

Dieses Cmdlet gibt ein Task-Objekt zurück.

Hinweise

  • Dieses Cmdlet erfordert ein VMM-Auftragsobjekt, das mithilfe des Cmdlets Get-SCJob abgerufen werden kann.