Delen via

Stop-SCJob

  • Referentie
Module:
VirtualMachineManager

Stopt met het uitvoeren van VMM-taken.

Syntaxis

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

Description

De Stop-SCJob cmdlet stopt een of meer VMM-taken (Virtual Machine Manager) die worden uitgevoerd en retourneert het object voor elke taak met een gestopte status. Als de VMM-taak momenteel niet wordt uitgevoerd, heeft deze cmdlet geen effect.

Voorbeelden

Voorbeeld 1: Alle actieve taken stoppen

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

Met de eerste opdracht worden alle VMM-taakobjecten opgehaald, wordt elk taakobject doorgegeven aan het 'where'-filter om alleen de taken te selecteren die momenteel worden uitgevoerd en worden de objecten opgeslagen in de $Job objectmatrix.

Met de tweede opdracht wordt elk object in $Job doorgegeven aan de cmdlet Stop-SCJob, waardoor elke actieve taak wordt gestopt.

Voorbeeld 2: Een specifieke actieve taak asynchroon stoppen

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

De eerste opdracht haalt alle VMM-taakobjecten op en selecteert in de resultaten alleen de taak op VM01 die wordt geïdentificeerd door taak-id cb3a0f0a-9fbc-4bd0-a999-3fae8cd77177 en slaat vervolgens het thie-object op in de $Job variabele.

De tweede opdracht stopt de taak en retourneert het gestopte taakobject aan de gebruiker.

Parameters

-Job

Hiermee geeft u een VMM-taakobject op.

Type:Task
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-OnBehalfOfUser

Hiermee geeft u een gebruikersnaam. Deze cmdlet werkt namens de gebruiker die deze parameter opgeeft.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-OnBehalfOfUserRole

Hiermee geeft u een gebruikersrol op. Gebruik de cmdlet Get-SCUserRole om een gebruikersrol te verkrijgen. Deze cmdlet werkt namens de gebruikersrol die met deze parameter wordt opgegeven.

Type:UserRole
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Uitvoerwaarden

Task

Deze cmdlet retourneert een Task-object.

Notities

  • Voor deze cmdlet is een VMM-taakobject vereist dat kan worden opgehaald met behulp van de cmdlet Get-SCJob.