Atualizar todos os endereços IP públicos anexados a VMs em um Conjunto de Disponibilidade do Básico para o Standard
Importante
Em 30 de setembro de 2025, os IPs públicos do SKU Básico serão desativados. Para saber mais, confira o anúncio oficial. Se você estiver usando os IPs públicos do SKU Básico, certifique-se de atualizar para IPs públicos do SKU Standard antes da data de desativação. Este artigo ajudará a guiá-lo durante o processo de atualização.
Para obter mais informações sobre a desativação de IPs Públicos de SKU Básico e os benefícios dos IPs Públicos de SKU Standard, confira aqui
Visão geral da atualização
Esse script atualiza todos os endereços IP públicos anexados às VMs (Máquinas Virtuais) em um Conjunto de Disponibilidade do SKU Básico para SKU Standard. Para executar a atualização, o método de alocação do endereço IP Público é definido como estático antes de ser desassociado de cada VM. Depois de desassociado, o SKU de IP público é atualizado para Standard e, em seguida, o IP é associado novamente com a VM original até que todos os IPs sejam atualizados.
Como a alocação de IP público é definida como ''Estática'' antes de desanexar das VMs, os endereços IP não são alterados durante o processo de atualização, mesmo no caso de uma falha de script. O módulo verifica duas vezes se o método de alocação do IP Público é ''Estático'' antes de desanexar o IP Público da VM.
O módulo registra todas as atividades de atualização em um arquivo chamado AvSetPublicIPUpgrade.log, criado no mesmo local em que o módulo foi executado (por padrão).
Restrições/ Cenários sem suporte
VMs com interfaces de rede associadas a um Load Balancer: como o Load Balancer e os SKUs de IP Público associados a uma VM devem corresponder, não é possível atualizar os endereços IP públicos no nível da instância associados a uma VM quando as interfaces de rede da VM também estão associadas a um Load Balancer, por meio do Pool de Back-end ou da afiliação ao Pool de NAT. Use os scripts Atualizar um Load Balancer Básico para a SKU Standard para atualizar o Load Balancer e os IPs públicos ao mesmo tempo.
VMs sem um Grupo de Segurança de Rede: as VMs com IPs a serem atualizadas devem ter um NSG (Grupo de Segurança de Rede) associado à sub-rede de cada configuração de IP com um IP Público ou diretamente com a NIC. Isso ocorre porque os IPs Públicos de SKU Standard são "seguros por padrão", o que significa que qualquer tráfego para o IP Público deve ser explicitamente permitido em um NSG para acessar a VM. Os IPs Públicos de SKU Básico permitem qualquer tráfego por padrão. Atualizar SKUs de IP Público sem um NSG resultaria em tráfego de internet de entrada para o IP Público permitido anteriormente com o SKU Básico. Confira: SKUs de IP Público
Baixar o script
Baixe o script de migração pela Galeria do PowerShell.
Install-Module -Name AzureAvSetBasicPublicIPUpgrade -Scope CurrentUser -Repository PSGallery -Force
Usar o módulo
Use
Select-AzSubscriptionpara selecionar a assinatura do Azure em que o Conjunto de Disponibilidade existeSelect-AzSubscription -Subscription <SubscriptionId>Localize o Conjunto de Disponibilidade com os IPs Públicos Básicos anexados que você deseja atualizar. Registre seu nome e o nome do grupo de recursos.
Examine os parâmetros do módulo:
- AvailabilitySetName [cadeia de caracteres] Obrigatório – esse parâmetro é o nome do Conjunto de Disponibilidade.
- ResourceGroupName [cadeia de caracteres] Obrigatório – esse parâmetro é o grupo de recursos do Conjunto de Disponibilidade com os IPs públicos básicos anexados que você deseja atualizar.
Execute a atualização usando os exemplos a seguir ou
Get-Help Start-AzAvSetPublicIPUpgradepara obter diretrizes.
Usos de exemplo do script
Atualize as VMs em um único Conjunto de Disponibilidade, passando o nome do Conjunto de Disponibilidade e o nome do grupo de recursos como parâmetros.
Start-AzAvSetPublicIPUpgrade -availabilitySetName 'myAvSet' -resourceGroupName 'myRG'
Avaliar VMs em um único Conjunto de Disponibilidade, sem fazer alterações
Start-AzAvSetPublicIPUpgrade -availabilitySetName 'myAvSet' -resourceGroupName 'myRG' -WhatIf
Tente atualizar as VMs em cada Conjunto de Disponibilidade ao qual o usuário tem acesso. VMs sem IPs públicos, que já foram atualizados ou que não têm NSGs, são ignoradas.
Get-AzAvailabilitySet -resourceGroupName 'myRG' | Start-AzAvSetPublicIPUpgrade -skipVMMissingNSG
Recupere-se de uma migração com falha, passando o nome e o grupo de recursos do Conjunto de Disponibilidade para recuperação, juntamente com o arquivo de log de recuperação.
Start-AzAvSetPublicIPUpgrade -RecoverFromFile ./AvSetPublicIPUpgrade_Recovery_2020-01-01-00-00.csv -AvailabilitySetName myAvSet -ResourceGroup rg-myrg
Recuperando-se de uma migração com falha
Se uma migração falhar devido a um problema transitório, como uma interrupção de rede ou um problema no sistema cliente, a migração poderá ser executada novamente para configurar a VM e os IPs Públicos no estado de meta. Na execução, o script gera um arquivo de log de recuperação, que é usado para garantir que a VM seja reconfigurada corretamente. Examine o arquivo de log AvSetPublicIPUpgrade.log criado no local onde o script foi executado.
Para se recuperar de uma atualização com falha, passe o caminho do arquivo de log de recuperação para o script com o parâmetro -recoverFromFile e identifique o Conjunto de Disponibilidade a ser recuperado com o parâmetro -AvailabilitySetName, conforme mostrado neste exemplo.
Start-VMPublicIPUpgrade -RecoverFromFile ./AvSetPublicIPUpgrade_Recovery_2020-01-01-00-00.csv -AvailabilitySetName myAvSet -ResourceGroupName rg-myrg
Perguntas comuns
Quanto tempo a migração levará e quanto tempo minha VM ficará inacessível em seu IP Público?
O tempo necessário para atualizar os IPs Públicos de uma VM depende do número de IPs Públicos e Adaptadores de Rede associados à VM. No teste, uma VM com uma única NIC e IP Público leva entre 1 e 2 minutos para ser atualizada. Cada NIC da VM adiciona cerca de mais um minuto e cada IP Público adiciona alguns segundos cada.
Posso reverter para um IP Público de SKU Básico?
Não é possível fazer downgrade de um IP Standard para um Básico.
Posso testar uma migração antes de executar?
Não há como avaliar a atualização de um IP Público sem concluir a ação. No entanto, esse script inclui um parâmetro -WhatIf, que verifica se as VMs do Conjunto de Disponibilidade darão suporte à atualização e percorrem as etapas sem tomar medidas.
O script dá suporte a IPs Públicos de SKU Básico Zonal?
Sim, o processo de atualização de um IP Público de SKU Básico Zonal para um IP Público de SKU Standard Zonal é idêntico e funciona no script.