Join-SCVirtualMachine

  • Referência
Módulo:
VirtualMachineManager

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

Syntax

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 pertencentes 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 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 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 função de serviço ou máquina virtual e não foi modificado.

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, 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.

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, armazena-a 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 .

Type:ComputerTier
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-JobVariable

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUser

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:UserRole
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PROTipID

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

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsynchronously

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VM

Especifica um objeto VM .

Type:VM
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VMRole

Especifica um objeto CloudVMRole .

Type:CloudVmRole
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False