Como renomear uma VM do Azure via Powershell

A implantação de Máquinas Virtuais do Azure é fácil, dadas as ferramentas fornecidas pela Microsoft. Você pode editar propriedades, marcas ou até mesmo redimensionar VMs do Azure após a implantação. Mas, renomear VMs do Azure ou qualquer outro recurso não é permitido.

A Microsoft deve ter um bom motivo para não incluir isso como um recurso embutido. Até que isso se torne um recurso oficial, os administradores são deixados por conta própria sobre como renomear VMs do Azure.

Felizmente, há uma solução alternativa para essa limitação. Isso inclui excluir a máquina virtual antiga, preservando todos os recursos relacionados. Em seguida, crie uma nova máquina virtual com um novo nome e recursos antigos, como endereço IP e discos.

Neste artigo, você aprenderá como renomear VMs do Azure com alguns dos bons e velhos scripts do PowerShell. Vamos começar.

Leia Mais:

Curso Grátis – Fundamentos da Computação em Nuvem
Configurando Azure AD Connect passo a passo
Armazenamento em nuvem e seus benefícios
Quarentena aumenta demanda do Microsoft Azure em 775%
Configurando o Self-Service Password Reset para Azure e Office 365

Requisitos

Se você planeja seguir os exemplos e demonstrações, aqui estão alguns requisitos básicos.

  • Uma assinatura do Azure. Você pode solicitar um teste, se ainda não tiver um.
  • Uma VM do Azure a ser renomeada. Não que eu precise lembrá-lo, mas não use um servidor de produção, por favor? Se você ainda não tem uma VM de teste, consulte Criar uma máquina virtual do Windows no portal do Azure para saber como criar uma.
  • Windows PowerShell 5.1 ou PowerShell Core 6+. Estou usando o PowerShell 7.0.0-preview.6 em meu ambiente de teste.
  • O módulo Az PowerShell .
  • Um editor de script de sua escolha. Estou usando o Visual Studio Code no meu PC. Use aquele com o qual você se sentir confortável.

Etapa 1: fazer backup das propriedades da máquina virtual antiga

É importante fazer backup das propriedades atuais da máquina virtual. Lembre-se de que essas propriedades incluem o ID do disco do sistema operacional, o tipo de sistema operacional e o tamanho da VM, para citar alguns. Ter um backup é essencial para restaurar os mesmos valores para a máquina virtual resultante.

Conecte-se ao Azure PowerShell primeiro antes de executar esses comandos. Consulte Entrar no Azure PowerShell para obter detalhes. Selecione a assinatura do Azure para usar usando o cmdlet Select-AzSubscription.

Usando seu editor, crie um novo script do PowerShell e copie / cole o código abaixo nele.

#DicaProfissa: Faça um curso profissionalizante!
Garanta um curso certificado na área de TI e Software pela plataforma de estudos online Udemy.
Clique aqui e confira todos os cursos mais recentes em tecnologia!

Primeiro, defina o nome da máquina virtual e o grupo de recursos que a possui. Em meu locatário, tenho demo-mail1 (máquina virtual) dentro de demo_group (grupo de recursos).

  • Nome do grupo de recursos
$ ResourceGroupName = 'demo_group'
  • Nome da máquina virtual
$ VirtualMachineName = 'demo-mail1'

Em seguida, este próximo comando exportará as propriedades da VM do Azure para um arquivo XML. Salve-o em algum lugar do seu computador que você possa encontrar mais tarde. O código abaixo salva as configurações da VM em * C: _Backup.xml *.

  • Exportar propriedades da VM
Get-AzVM -ResourceGroupName $ ResourceGroupName -Name $ VirtualMachineName | Export-Clixml C: \ Demo \ VM_Backup.xml -Depth 5

Agora você tem um backup das propriedades originais da VM que pode usar como referência quando necessário. Use o comando a seguir para importar o arquivo XML de backup para uma variável chamada $ oldVM.

  • Importe as configurações da VM do XML de backup e armazene-as em uma variável
$ oldVM = Import-Clixml C: \ Demo \ VM_Backup.xml

Etapa 2: Excluindo a Máquina Virtual Antiga

Agora que você fez backup dos detalhes da máquina virtual antiga, a próxima etapa é excluir a máquina virtual antiga.

Na etapa anterior, os detalhes da máquina virtual antiga foram importados para a variável $ oldVM. Usaremos esse objeto como referência para excluir a máquina virtual antiga. Use este próximo comando para remover a máquina virtual.

  • Exclua o antigo VM
Remove-AzVM -ResourceGroupName $ oldVM.ResourceGroupName -Name $ oldVM.Name

#DicaProfissa: Faça um curso profissionalizante!
Garanta um curso certificado na área de TI e Software pela plataforma de estudos online Udemy.
Clique aqui e confira todos os cursos mais recentes em tecnologia!

O código acima exclui a máquina virtual que corresponde ao nome e grupo de recursos da máquina virtual antiga que está na variável $ oldVM. Quando concluído, a captura de tela abaixo mostra o que você esperaria como resultado.

A captura de tela acima mostra que a máquina virtual foi removida.

Você pode estar se perguntando “e os outros recursos conectados à máquina virtual que foi excluída?”. Não se preocupe porque esses recursos não foram alterados.

O comando anterior excluiu apenas a máquina virtual. Você pode confirmar procurando por eles no portal do Azure no grupo de recursos.

Como você pode ver na captura de tela acima do portal do Azure, apenas a Máquina Virtual está faltando na lista. Todos os outros recursos estão intactos. Esses recursos serão conectados à nova máquina virtual manualmente assim que ela for criada.

Etapa 3: Criando a nova máquina virtual

A exclusão da máquina virtual também liberou os recursos anteriormente associados a ela. Nesta seção, você empacotará as novas propriedades da máquina virtual antes de criá-la.

Para iniciar uma nova configuração de VM, copie / cole o script abaixo. Certifique-se de alterar o valor $ newVMName para o novo nome que deseja atribuir. Estou usando o nome demo-mail2 neste exemplo.

  • Defina o nome da nova máquina virtual
$ newVMName = 'demo-mail2'
  • Inicie uma nova configuração de máquina virtual
$ newVM = New-AzVMConfig -VMName $ newVMName -VMSize $ oldVM.HardwareProfile.VmSize -Tags $ oldVM.Tags

Em seguida, conecte o disco do sistema operacional que foi anexado anteriormente à máquina virtual antiga à nova. Use o código abaixo para fazer isso.

  • Anexe o disco do sistema operacional da VM antiga à nova VM
Set-AzVMOSDisk -VM $ newVM -CreateOption Attach -ManagedDiskId $ oldVM.StorageProfile.OsDisk.ManagedDisk.Id -Name $ oldVM.StorageProfile.OsDisk.Name -Windows

Agora, conecte a interface de rede usando a próxima linha de código.

  • Anexe todos os NICs da VM antiga à nova VM
$ oldVM.NetworkProfile.NetworkInterfaces | % {Add-AzVMNetworkInterface -VM $ newVM -Id $ _. Id}

E, finalmente, anexe todos os discos de dados que estavam presentes na VM antiga.

  • Anexe todos os discos de dados (se houver) da VM antiga à nova VM
$ oldVM.StorageProfile.DataDisks | % {Add-AzVMDataDisk -VM $ newVM -Name $ _. Name -ManagedDiskId $ _. ManagedDisk.Id -Caching $ _. Caching -Lun $ _. Lun -DiskSizeInGB $ _. DiskSizeGB -CreateOption Attach}

Neste ponto, as novas especificações da máquina virtual são empacotadas na configuração armazenada na variável $ newVM. O uso deste próximo trecho de código acionará a criação da nova máquina virtual.

  • Crie a nova máquina virtual
New-AzVM -ResourceGroupName $ ResourceGroupName -Location $ oldVM.Location -VM $ newVM

A criação da VM pode levar alguns minutos. Quando terminar, a captura de tela abaixo mostra a saída esperada de uma criação de VM bem-sucedida.

Você pode confirmar a existência da nova VM executando o comando Get-AzVM abaixo.

Get-AzVM -ResourceGroupName $ ResourceGroupName -VMName $ newVMName

Como você pode ver no exemplo de saída abaixo, a VM com o nome demo-mail2 está presente.

#DicaProfissa: Faça um curso profissionalizante!
Garanta um curso certificado na área de TI e Software pela plataforma de estudos online Udemy.
Clique aqui e confira todos os cursos mais recentes em tecnologia!

Outras considerações

As etapas descritas acima são básicas e gerais. Pode haver outros detalhes importantes que precisam ser incluídos na máquina virtual renomeada.

Algumas configurações só podem ser definidas durante a criação, portanto, elas também devem ser consideradas cuidadosamente antes de passar por todas essas etapas. Um exemplo é o conjunto de Disponibilidade ao qual a VM pode ser adicionada apenas quando a VM é criada.

Além disso, renomear a VM usando este procedimento não renomeia automaticamente o nome do computador no sistema operacional. Quando a VM renomeada estiver ativada, considere alterar o nome do computador.

Este artigo foi útil?

Para manter um padrão de qualidade para vocês, investimos em um ótimo plano de hospedagem, CDN Pago, Plugins de Otimização para o Site, etc…

Ajude-nos a manter o projeto ativo! 

Acompanhe as novidades em tempo real. Siga nosso perfil no Instagram..

Felipe Santos
Felipe Santos é Arquiteto de Cloud e Segurança, com vivência em Administração de Ambientes Windows Server, Cluster, Storages, Backups Veeam e Office 365.
pt_BRPortuguese

ATÉ 90% DE DESCONTO

DECOLE SUA CARREIRA!!

Quer dar um upgrade na sua carreira? 

Invista em você e saia na frente! Conquiste aquele emprego dos sonhos em 2022!