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 reassocia uma máquina virtual órfã ao seu serviço ou função de máquina virtual.

Quando um host ou cluster é removido do Virtual Machine Manager (VMM), 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, operações somente de banco de dados são executadas e nenhum ajuste é feito na máquina virtual. Presume-se que a máquina virtual está em execução e que todos os aplicativos e serviços convidados em execução nela estão intactos.

A camada de computador à qual você deseja ingressar na máquina virtual deve estar sendo executada abaixo de sua contagem máxima de instâncias. O domínio de atualização para a operação de associaçã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, em seguida, armazena-a 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.

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

O segundo comando obtém o recurso de nuvem chamado ContosoShop e, em seguida, armazena-o 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.