New-SCExternalJob
Tworzy nowe zadanie zewnętrzne w programie VMM.
Składnia
Default (Domyślna)
New-SCExternalJob
[-VMMServer <ServerConnection>]
[-Name] <String>
[-ResultObject <ClientObject>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Opis
Polecenie cmdlet New-SCExternalJob tworzy zadania zewnętrzne w programie Virtual Machine Manager (VMM).
Zadania zewnętrzne dodają zadania inne niż VMM do widoku zadań w konsoli programu VMM. Te zadania są zwykle używane, aby umożliwić innym aplikacjom integrującym się z programem VMM udostępnianie aktualizacji stanu w konsoli, dzięki czemu użytkownicy konsoli mogą zobaczyć aktualizacje. Na przykład w przypadku tworzenia dodatku można użyć zadań zewnętrznych, aby określić stan pracy wykonanej w innym systemie.
Przykłady
Przykład 1: Tworzenie zadania zewnętrznego
PS C:\> $VMMObject = Get-SCVirtualMachine -Name "VM01"
PS C:\> New-SCExternalJob -Name "ExternalJob01" -ResultObject $VMMObject
Pierwsze polecenie pobiera obiekt maszyny wirtualnej o nazwie VM01 i zapisuje obiekt w zmiennej $VMMObject. Obiektem w tym poleceniu może być dowolny obiekt programu VMM, dla którego jest tworzone zadanie.
Drugie polecenie tworzy zadanie zewnętrzne o nazwie ExternalJob01 i wiąże je z maszyną VM01, która jest przechowywana w zmiennej $VMMObject.
Parametry
-Name
Określa nazwę obiektu programu VMM.
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | 0 |
| Obowiązkowy: | True |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-OnBehalfOfUser
Określa nazwę użytkownika. To polecenie cmdlet działa w imieniu użytkownika, którego określa ten parametr.
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-OnBehalfOfUserRole
Określa rolę użytkownika. Aby uzyskać rolę użytkownika, użyj polecenia cmdlet Get-SCUserRole . To polecenie cmdlet działa w imieniu roli użytkownika określonej przez ten parametr.
Właściwości parametru
| Typ: | UserRole |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-ResultObject
Określa obiekt, z którym powiązane jest nowe zadanie zewnętrzne.
Właściwości parametru
| Typ: | ClientObject |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-VMMServer
Określa obiekt serwera programu VMM.
Właściwości parametru
| Typ: | ServerConnection |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | True |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
CommonParameters
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.
Dane wyjściowe
Task
To polecenie cmdlet zwraca obiekt Task .