Sdílet prostřednictvím

New-SCExternalJob

Modul:
virtualmachinemanager

Vytvoří novou externí úlohu v nástroji VMM.

Syntaxe

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

Description

Rutina New-SCExternalJob vytváří externí úlohy v nástroji Virtual Machine Manager (VMM).

Externí úlohy přidávají úlohy jiné než VMM do zobrazení úloh v konzole VMM. Tyto úlohy se obvykle používají k tomu, aby jiné aplikace integrující se s nástrojem VMM mohly poskytovat aktualizace stavu do konzoly, aby uživatelé konzoly mohli aktualizace zobrazit. Pokud například vytvoříte doplněk, můžete použít externí úlohy k zajištění stavu dokončené práce v jiném systému.

Příklady

Příklad 1: Vytvoření externí úlohy

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

První příkaz získá objekt virtuálního počítače s názvem VM01 a uloží jej do proměnné $VMMObject. Objektem v tomto příkazu může být libovolný objekt VMM, pro který vytváříte úlohu.

Druhý příkaz vytvoří externí úlohu s názvem ExternalJob01 a propojí úlohu s VM01, která je uložena v proměnné $VMMObject.

Parametry

-Name

Určuje název objektu VMM.

Typ:String
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-OnBehalfOfUser

Určuje uživatelské jméno. Tato rutina pracuje jménem uživatele, kterého tento parametr určuje.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-OnBehalfOfUserRole

Určuje roli uživatele. Pokud chcete získat roli uživatele, použijte rutinu Get-SCUserRole . Tato rutina pracuje jménem role uživatele, kterou tento parametr určuje.

Typ:UserRole
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ResultObject

Určuje objekt, ke kterému se vztahuje nová externí úloha.

Typ:ClientObject
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-VMMServer

Určuje objekt serveru VMM.

Typ:ServerConnection
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

Výstupy

Task

Tato rutina vrátí objekt Task .