New-SCExternalJob
在 VMM 中建立新的外部作業。
語法
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 物件的名稱。
類型: | String |
Position: | 0 |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-OnBehalfOfUser
指定用戶名稱。 這個 Cmdlet 代表此參數指定的用戶運作。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-OnBehalfOfUserRole
指定使用者角色。 若要取得使用者角色,請使用 Get-SCUserRole Cmdlet。 這個 Cmdlet 代表此參數指定的使用者角色運作。
類型: | UserRole |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-ResultObject
指定新的外部作業相關物件。
類型: | ClientObject |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-VMMServer
指定 VMM 伺服器物件。
類型: | ServerConnection |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
輸出
Task
此 Cmdlet 會傳回 Task 物件。