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 对象。