Compartilhar via

New-SCExternalJob

  • Referência
Módulo:
VirtualMachineManager

Cria um novo trabalho externo no VMM.

Sintaxe

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 do VMM.

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-OnBehalfOfUser

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.

Tipo:UserRole
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ResultObject

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

Tipo:ClientObject
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-VMMServer

Especifica um objeto de servidor do VMM.

Tipo:ServerConnection
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Saídas

Task

Esse cmdlet retorna um objeto Task.