New-SCExternalJob
在 VMM 中创建新的外部作业。
语法
New-SCExternalJob
[-VMMServer <ServerConnection>]
[-Name] <String>
[-ResultObject <ClientObject>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
说明
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 对象。