New-SCExternalJob

Modul:: virtualmachinemanager

Erstellt einen neuen externen Auftrag in VMM.

Syntax

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

Beschreibung

Mit dem Cmdlet New-SCExternalJob werden externe Aufträge in Virtual Machine Manager (VMM) erstellt.

Externe Aufträge fügen der Auftragsansicht in der VMM-Konsole Nicht-VMM-Aufträge hinzu. Diese Aufträge werden in der Regel verwendet, damit andere Anwendungen, die in VMM integriert sind, Statusaktualisierungen in der Konsole bereitstellen können, damit Benutzer der Konsole die Updates sehen können. Wenn Sie z. B. ein Add-In erstellen, können Sie externe Aufträge verwenden, um den Status der auf einem anderen System abgeschlossenen Arbeit anzugeben.

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 VM-Objekt mit dem Namen VM01 ab und speichert das Objekt in der Variablen $VMMObject. Bei dem Objekt in diesem Befehl kann es sich um ein beliebiges VMM-Objekt handeln, für das Sie einen Auftrag erstellen.

Der zweite Befehl erstellt einen externen Auftrag mit dem Namen ExternalJob01 und verknüpft den Auftrag mit VM01, der in der Variablen $VMMObject gespeichert ist.

Parameter

-Name

Gibt den Namen eines VMM-Objekts an.

Typ:	String
Position:	0
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-OnBehalfOfUser

Gibt einen Benutzernamen an. Dieses Cmdlet wird im Namen des Benutzers ausgeführt, der durch diesen Parameter angegeben wird.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-OnBehalfOfUserRole

Gibt eine Benutzerrolle an. Verwenden Sie zum Abrufen einer Benutzerrolle das Cmdlet Get-SCUserRole . Dieses Cmdlet wird im Namen der Benutzerrolle ausgeführt, die durch diesen Parameter angegeben wird.

Typ:	UserRole
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ResultObject

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

Typ:	ClientObject
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-VMMServer

Gibt ein VMM-Serverobjekt an.

Typ:	ServerConnection
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

Ausgaben

Task

Dieses Cmdlet gibt ein Task-Objekt zurück.

Set-SCExternalJob

Freigeben über