New-SCExternalJob
在 VMM 中建立新的外部作業。
Syntax
New-SCExternalJob
[-VMMServer <ServerConnection>]
[-Name] <String>
[-ResultObject <ClientObject>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Description
New-SCExternalJob Cmdlet 會在 Virtual Machine Manager (VMM) 中建立外部作業。
外部作業會將非 VMM 作業新增至 VMM 主控台中的作業檢視。 這些作業通常用來允許與 VMM 整合的其他應用程式將狀態更新提供給主控台,讓主控台的使用者可以看到更新。 例如,如果您建立增益集,您可以使用外部作業來提供在另一個系統上完成的工作狀態。
範例
範例 1:建立外部作業
PS C:\> $VMMObject = Get-SCVirtualMachine -Name "VM01"
PS C:\> New-SCExternalJob -Name "ExternalJob01" -ResultObject $VMMObject
第一個命令會取得名為 VM01 的虛擬機器物件,並將物件儲存在 $VMMObject 變數中。 此命令中的 物件可以是您要建立作業的任何 VMM 物件。
第二個命令會建立名為 ExternalJob01 的外部作業,並將作業與儲存在 $VMMObject 變數中的 VM01 產生關聯。
參數
-Name
指定 VMM 物件的名稱。
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OnBehalfOfUser
指定使用者名稱。 此 Cmdlet 代表此參數指定的使用者運作。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OnBehalfOfUserRole
指定使用者角色。 若要取得使用者角色,請使用 Get-SCUserRole Cmdlet。 此 Cmdlet 代表此參數所指定的使用者角色運作。
Type: | UserRole |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResultObject
指定與新外部作業相關的 物件。
Type: | ClientObject |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VMMServer
指定 VMM 伺服器物件。
Type: | ServerConnection |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
輸出
Task
此 Cmdlet 會傳回 Task 物件。