Delen via

New-SCExternalJob

  • Referentie
Module:
VirtualMachineManager

Hiermee maakt u een nieuwe externe taak in VMM.

Syntax

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

Description

Met de cmdlet New-SCExternalJob worden externe taken gemaakt in Virtual Machine Manager (VMM).

Externe taken voegen niet-VMM-taken toe aan de taakweergave in de VMM-console. Deze taken worden doorgaans gebruikt om andere toepassingen die met VMM integreren, 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 werk op te geven dat is voltooid op een ander systeem.

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
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUser

Hiermee geeft u een gebruikersnaam op. Deze cmdlet werkt namens de gebruiker die met deze parameter wordt opgegeven.

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

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

-ResultObject

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

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

-VMMServer

Hiermee geeft u een VMM-serverobject op.

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

Uitvoerwaarden

Task

Met deze cmdlet wordt een taakobject geretourneerd.