Partilhar via

Join-SCVirtualMachine

  • Referência
Módulo:
VirtualMachineManager

Associa novamente uma máquina virtual órfã à função de serviço ou máquina virtual.

Sintaxe

Join-SCVirtualMachine
    [-VM] <VM>
    -ComputerTier <ComputerTier>
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]
Join-SCVirtualMachine
    [-VM] <VM>
    -VMRole <CloudVmRole>
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

Description

O cmdlet Join-SCVirtualMachine associa novamente uma máquina virtual órfã à função de serviço ou máquina virtual.

Quando um host ou cluster é removido do VMM (Virtual Machine Manager), todas as máquinas virtuais que pertencem a um serviço ou uma função de máquina virtual implantada no host permanecem funcionais. No entanto, ao adicionar o host ou cluster de volta ao VMM, as máquinas virtuais ficam órfãs no sentido de que elas não têm mais nenhuma associação com seu serviço ou função de máquina virtual.

Você pode usar esse cmdlet para restaurar a associação entre uma máquina virtual e sua função de serviço ou máquina virtual. O cmdlet Join-SCVirtualMachine executa uma tarefa de associação nova no VMM que executa um conjunto de validações que ajudam a confirmar a compatibilidade da máquina virtual com o modelo de serviço.

Quando o cmdlet valida a compatibilidade da máquina virtual com o modelo de camada de computador, as operações somente banco de dados são executadas e nenhum ajuste é feito na máquina virtual. Supõe-se que a máquina virtual esteja em execução e que todos os aplicativos e serviços convidados em execução nela estejam intactos.

A camada de computador à qual você deseja ingressar na máquina virtual deve estar em execução abaixo de sua contagem máxima de instâncias. O domínio de atualização da operação de junção é semelhante a uma expansão.

Para obter melhores resultados, use esse cmdlet com uma máquina virtual que originalmente fazia parte de uma implantação de função de serviço ou máquina virtual e não foi modificada.

Exemplos

Exemplo 1: unir uma máquina virtual órfã a uma camada de serviço

PS C:\> $VM = Get-SCVirtualMachine -Name "PS-Web-001" 
PS C:\> $CT = Get-SCComputerTier -Name "MyService-WebTier" 
PS C:\> Join-SCVirtualMachine -VM $VM -ComputerTier $CT

O primeiro comando obtém a máquina virtual chamada PS-Web-001 e, em seguida, a armazena na variável $VM.

O segundo comando obtém a camada de computador chamada MyService-WebTier e, em seguida, armazena-a na variável $CT.

O último comando une a máquina virtual em $VM à camada de computador em $CT.

Exemplo 2: unir uma máquina virtual órfã a uma função de máquina virtual

PS C:\> $VM = Get-SCVirtualMachine -Name "PS-Web-001" 
PS C:\> $VmRole = Get-CloudResource -Name "ContosoShop" 
PS C:\> Join-SCVirtualMachine -VM $VM -VMRole $VmRole

O primeiro comando obtém a máquina virtual chamada PS-Web-001 e, em seguida, a armazena na variável $VM.

O segundo comando obtém o recurso de nuvem chamado ContosoShop e o armazena na variável $VmRole.

O último comando une a máquina virtual em $VM à função no $VMRole.

Parâmetros

-ComputerTier

Especifica um objeto ComputerTier.

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

-JobVariable

Especifica uma variável na qual o progresso do trabalho é acompanhado e armazenado.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
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

-PROTipID

Especifica a ID da dica de Otimização de Recursos e Desempenho (dica PRO) que disparou essa ação. Esse parâmetro permite que você audite dicas pro.

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

-RunAsynchronously

Indica que o trabalho é executado de forma assíncrona para que o controle retorne ao shell de comando imediatamente.

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

-VM

Especifica um objeto de VM .

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

-VMRole

Especifica um objeto CloudVMRole.

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