Freigeben über

New-SCExternalJob

  • Referenz
Modul:
VirtualMachineManager

Erstellt einen neuen externen Auftrag in VMM.

Syntax

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

Beschreibung

Das Cmdlet New-SCExternalJob erstellt externe Aufträge im Virtual Machine Manager (VMM).

Externe Aufträge fügen der Auftragsansicht in der VMM-Konsole nicht VMM-Aufträge hinzu. Diese Aufträge werden in der Regel verwendet, um anderen Anwendungen die Integration in VMM zu ermöglichen, Statusupdates in die Konsole zu bedienen, damit Benutzer der Konsole die Updates sehen können. Wenn Sie beispielsweise ein Add-In erstellen, können Sie externe Aufträge verwenden, um den Status der abgeschlossenen Arbeit auf einem anderen System bereitzustellen.

Beispiele

Beispiel 1: Erstellen eines externen Auftrags

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

Der erste Befehl ruft das virtuelle Computerobjekt mit dem Namen VM01 ab und speichert das Objekt in der $VMMObject Variablen. Das Objekt in diesem Befehl kann ein beliebiges VMM-Objekt sein, für das Sie einen Auftrag erstellen.

Der zweite Befehl erstellt einen externen Auftrag namens ExternalJob01 und bezieht den Auftrag auf VM01, der in der variablen $VMMObject gespeichert ist.

Parameter

-Name

Gibt den Namen eines VMM-Objekts an.

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

-OnBehalfOfUser

Gibt einen Benutzernamen an. Dieses Cmdlet wird im Namen 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. Um eine Benutzerrolle abzurufen, verwenden Sie das Cmdlet Get-SCUserRole . Dieses Cmdlet wird im Namen 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

-ResultObject

Gibt das Objekt an, mit dem ein neuer externer Auftrag verknüpft ist.

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

-VMMServer

Gibt ein VMM-Serverobjekt an.

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

Ausgaben

Task

Dieses Cmdlet gibt ein Task-Objekt zurück.