New-SCExternalJob

  • Referência
Módulo:
VirtualMachineManager

Cria um novo trabalho externo no VMM.

Syntax

New-SCExternalJob
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [-ResultObject <ClientObject>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

O cmdlet New-SCExternalJob cria trabalhos externos no VMM (Virtual Machine Manager).

Trabalhos externos adicionam trabalhos não VMM à exibição de trabalhos no console do VMM. Esses trabalhos normalmente são usados para permitir que outros aplicativos integrados ao VMM atendam atualizações de status no console para que os usuários do console possam ver as atualizações. Por exemplo, se você criar um suplemento, poderá usar trabalhos externos para fornecer o status do trabalho concluído em outro sistema.

Exemplos

Exemplo 1: criar um trabalho externo

PS C:\> $VMMObject = Get-SCVirtualMachine -Name "VM01"
PS C:\> New-SCExternalJob -Name "ExternalJob01" -ResultObject $VMMObject

O primeiro comando obtém o objeto de máquina virtual chamado VM01 e armazena o objeto na variável $VMMObject. O objeto neste comando pode ser qualquer objeto VMM para o qual você está criando um trabalho.

O segundo comando cria um trabalho externo chamado ExternalJob01 e relaciona o trabalho à VM01, que é armazenada na variável $VMMObject.

Parâmetros

-Name

Especifica o nome de um objeto VMM.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUser

Especifica um nome de usuário. Esse cmdlet opera em nome do usuário especificado por esse parâmetro.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUserRole

Especifica uma função de usuário. Para obter uma função de usuário, use o cmdlet Get-SCUserRole . Esse cmdlet opera em nome da função de usuário especificada por esse parâmetro.

Type:UserRole
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResultObject

Especifica o objeto ao qual um novo trabalho externo está relacionado.

Type:ClientObject
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMMServer

Especifica um objeto de servidor do VMM.

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Saídas

Task

Esse cmdlet retorna um objeto Task .