Migrar para um gateway de rede virtual do ExpressRoute habilitado para zona de disponibilidade usando o PowerShell

Este artigo mostra como migrar um gateway de rede virtual do ExpressRoute de SKUs Standard, HighPerformance ou UltraPerformance para SKUs com suporte a zona de disponibilidade (ErGw1Az, ErGw2Az, ErGw3Az) usando o PowerShell. SKUs de nível superior fornecem mais CPUs e largura de banda de rede, resultando em maior taxa de transferência de rede e conexões mais confiáveis para sua rede virtual.

Prerequisites

Antes de começar, verifique se você tem:

• Leia o artigo sobre a migração do Gateway para obter informações importantes sobre a migração.
• Um gateway de rede virtual ExpressRoute existente usando a SKU Standard, Alto Desempenho ou Ultra Performance.
• Azure PowerShell instalado. Para obter mais informações, consulte Instalar o Azure PowerShell.

Trabalhando com o Azure PowerShell

As etapas e os exemplos deste artigo usam os módulos AZ do Azure PowerShell. Para instalar os módulos AZ localmente no computador, confira Instalar o Azure PowerShell. Para saber mais sobre o novo módulo AZ, confira Apresentando o novo módulo AZ do Azure PowerShell. Os cmdlets do PowerShell são atualizados com frequência. Se você não estiver executando a versão mais recente, os valores especificados nas instruções poderão falhar. Para localizar as versões instaladas do PowerShell no sistema, use o cmdlet Get-Module -ListAvailable Az.

Você pode usar o Azure Cloud Shell para executar a maioria dos cmdlets do PowerShell e dos comandos da CLI, em vez de instalar o Azure PowerShell ou a CLI localmente. O Azure Cloud Shell é um shell interativo gratuito que tem ferramentas comuns do Azure pré-instaladas e configuradas para uso com a conta. Para executar qualquer código contido neste artigo no Azure Cloud Shell, abra uma sessão do Cloud Shell, use o botão Copiar em um bloco de códigos para copiar o código e colá-lo na sessão do Cloud Shell com Ctrl+Shift+V no Windows e no Linux ou Cmd+Shift+V no macOS. O texto colado não é executado automaticamente, pressione Enter para executar o código.

Há algumas maneiras de inicializar o Cloud Shell:

Option	Link
Clique em Experimente no canto superior direito de um bloco de código.
Abra o Cloud Shell em seu navegador.
Clique no botão Cloud Shell no menu no canto superior direito do portal do Azure.

Migrar para um novo gateway usando o PowerShell

O processo de migração usa scripts do PowerShell para criar um novo gateway, transferir a configuração e remover o gateway antigo.

Clonar os scripts de migração

1. Clone os scripts de migração do repositório de exemplos do Azure:

   git clone https://github.com/Azure-Samples/azure-docs-powershell-samples/ 
   

2. Navegue até o diretório de migração do gateway do ExpressRoute:

   cd azure-docs-powershell-samples/expressroute-gateway/gateway-migration/
   

Preparar a migração

O script PrepareMigration cria um novo gateway de rede virtual do ExpressRoute na mesma sub-rede de gateway e o conecta aos circuitos existentes do ExpressRoute.

1. Obtenha o identificador do recurso do gateway existente:

   $resource = Get-AzResource -Name <gateway-name>
   $resource.Id
   

   Substitua <gateway-name> pelo nome do gateway de rede virtual.

2. Execute o script PrepareMigration.ps1:

   .\PrepareMigration.ps1
   

3. Quando solicitado, insira as seguintes informações:

   • ID do recurso do gateway
   • Sufixo de nome para seus novos recursos (esse nome é acrescentado ao nome existente, por exemplo: existingresourcename_newname)
   • Zona de disponibilidade para seu novo gateway

Executar a migração

O script de migração transfere a configuração do gateway antigo para o novo gateway.

1. Obtenha a ID do recurso do novo gateway usando o nome especificado na etapa de preparação:

   $resource = Get-AzResource -Name <new-gateway-name>
   $resource.Id
   

   Substitua <new-gateway-name> pelo nome do novo gateway de rede virtual.

2. Execute o script Migration.ps1.

   .\Migration.ps1
   

3. Quando solicitado, insira as seguintes informações:

   • ID do recurso do gateway original
   • ID de recurso do seu novo gateway

Confirme a migração

O script de confirmação remove o gateway antigo e suas conexões depois que você verifica se o novo gateway está funcionando corretamente.

1. Execute o script CommitMigration.ps1 :

   .\CommitMigration.ps1
   

2. Quando solicitado, insira a ID de recurso do gateway original.

Conteúdo relacionado

• Sobre os gateways de rede virtual do ExpressRoute
• Visão geral da migração do gateway