Delen via


New-SCExternalJob

Hiermee maakt u een nieuwe externe taak in VMM.

Syntaxis

New-SCExternalJob
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [-ResultObject <ClientObject>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

De cmdlet New-SCExternalJob maakt externe taken in Virtual Machine Manager (VMM).

Externe taken voegen niet-VMM-taken toe aan de takenweergave in de VMM-console. Deze taken worden doorgaans gebruikt om andere toepassingen die integreren met VMM, toe te staan statusupdates in de console te leveren, zodat gebruikers van de console de updates kunnen zien. Als u bijvoorbeeld een invoegtoepassing maakt, kunt u externe taken gebruiken om de status van het voltooide werk op een ander systeem op te geven.

Voorbeelden

Voorbeeld 1: Een externe taak maken

PS C:\> $VMMObject = Get-SCVirtualMachine -Name "VM01"
PS C:\> New-SCExternalJob -Name "ExternalJob01" -ResultObject $VMMObject

Met de eerste opdracht wordt het virtuele-machineobject met de naam VM01 opgehaald en wordt het object opgeslagen in de $VMMObject variabele. Het object in deze opdracht kan elk VMM-object zijn waarvoor u een taak maakt.

Met de tweede opdracht maakt u een externe taak met de naam ExternalJob01 en wordt de taak gekoppeld aan VM01 die is opgeslagen in de $VMMObject variabele.

Parameters

-Name

Hiermee geeft u de naam van een VMM-object.

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
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

-ResultObject

Hiermee geeft u het object waaraan een nieuwe externe taak is gerelateerd.

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

-VMMServer

Hiermee geeft u een VMM-serverobject.

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

Uitvoerwaarden

Task

Deze cmdlet retourneert een Task-object.