Join-SCVirtualMachine

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>]

O cmdlet Join-SCVirtualMachine associa novamente uma máquina virtual órfã à sua 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 pertencentes a um serviço ou a 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 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 seu serviço ou função de máquina virtual. O cmdlet Join-SCVirtualMachine executa uma tarefa de reassociação 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 de 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 para a 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 serviço ou função de máquina virtual e não foi modificada.

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 a armazena na variável $VM.

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

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

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 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 em $VMRole.

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.