Partilhar 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 Virtual Machine Manager (VMM).

Trabalhos externos adicionam trabalhos que não sejam do VMM à visualização de trabalhos no console do VMM. Esses trabalhos geralmente são usados para permitir que outros aplicativos integrados ao VMM forneçam 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 do VMM para o qual você está criando um trabalho.

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

Parâmetros

-Name

Especifica o nome de um objeto do VMM.

Tipo:String
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-OnBehalfOfUser

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

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-OnBehalfOfUserRole

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

Tipo:UserRole
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ResultObject

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

Tipo:ClientObject
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-VMMServer

Especifica um objeto de servidor VMM.

Tipo:ServerConnection
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

Saídas

Task

Este cmdlet retorna um objeto Task.