Sdílet prostřednictvím

New-SCExternalJob

  • Reference
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 vytvoří externí úlohy v nástroji Virtual Machine Manager (VMM).

Externí úlohy přidávají do zobrazení úloh v konzole VMM úlohy jiné úlohy než VMM. Tyto úlohy se obvykle používají k tomu, aby ostatní aplikace integrující s nástrojem VMM mohly poskytovat aktualizace stavu do konzoly, aby uživatelé konzoly viděli aktualizace. Pokud například vytvoříte doplněk, můžete pomocí externích úloh poskytnout stav 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ží ho do proměnné $VMMObject. Objekt 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 spojí úlohu s virtuálním počítačem VM01, který je uložený 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 funguje jménem uživatele, který 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 funguje 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, se kterým souvisí 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.