Partilhar via

Join-SCVirtualMachine

  • Referência
Módulo:
VirtualMachineManager

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

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

Pode utilizar este cmdlet para restaurar a associação entre uma máquina virtual e o seu papel de serviço ou máquina virtual. O cmdlet Join-SCVirtualMachine executa uma tarefa de readmenda 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 nível do computador, são realizadas operações apenas de base de dados e não são efetuados ajustes na máquina virtual. Presume-se que a máquina virtual está em funcionamento e que todas as aplicações e serviços de hóspedes que a executam estão intactos.

O nível de computador ao qual pretende aderir à máquina virtual deve estar a correr abaixo da sua contagem máxima de instância. O domínio de atualização para a operação de junção é semelhante a uma escala.

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

Exemplos

Exemplo 1: Junte uma máquina virtual órfã a um nível 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 recebe a máquina virtual chamada PS-Web-001, e depois armazena-a na variável $VM.

O segundo comando recebe o nível de computador chamado MyService-WebTier e, em seguida, armazena-o na variável $CT.

O último comando junta a máquina virtual em $VM ao nível do computador em $CT.

Exemplo 2: Junte uma máquina virtual órfã a um papel 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 recebe a máquina virtual chamada PS-Web-001, e depois armazena-a na variável $VM.

O segundo comando recebe o recurso de nuvem chamado ContosoShop, e depois armazena-o na variável $VmRole.

O último comando junta a máquina virtual em $VM ao papel na $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 em que 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 utilizador. Este cmdlet funciona em nome do utilizador que este parâmetro especifica.

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

-OnBehalfOfUserRole

Especifica uma função de utilizador. Para obter uma função de utilizador, utilize o cmdlet Get-SCUserRole . Este cmdlet funciona em nome da função de utilizador que este parâmetro especifica.

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

-PROTipID

Especifica o ID da ponta de otimização de desempenho e recursos (ponta PRO) que desencadeou esta ação. Este parâmetro permite-lhe auditar dicas PRO.

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

-RunAsynchronously

Indica que o trabalho funciona assíncronamente para que o controlo volte imediatamente à concha 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