Migrar uma Rede Virtual do Azure do clássico para o Resource Manager usando o Azure PowerShell

Artigo
05/11/2023

Neste artigo, você aprenderá a migrar do modelo de implantação clássico para o modelo de implantação mais recente do Resource Manager.

A migração do clássico para o Resource Manager é concluída uma rede virtual por vez. Não há um requisito adicional para ferramentas ou pré-requisitos para migração, além dos requisitos do Azure PowerShell. A migração é uma migração de plano de controle do recurso de rede virtual. Não há um tempo de inatividade do caminho de dados durante a migração. As cargas de trabalho existentes continuarão a funcionar sem perda de conectividade durante a migração. Quaisquer endereços IP públicos associados à rede virtual não mudam durante o processo de migração.

Quando a migração for concluída, todas as operações de gerenciamento devem ser executadas usando o modelo Resource Manager. As operações de gerenciamento só são acessíveis por meio do modelo de implantação do Resource Manager. As alterações de recurso de sub-rede ou rede virtual não estarão mais disponíveis por meio do modelo de implantação antigo.

Ao migra a rede virtual do modelo clássico para o Resource Manager, os recursos com suporte na rede virtual são migrados automaticamente para o novo modelo.

Pré-requisitos

Uma conta do Azure com uma assinatura ativa. Crie um gratuitamente.
As etapas e os exemplos deste artigo usam o módulo 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 encontrar as versões instaladas do PowerShell em seu sistema, use o cmdlet Get-Module -ListAvailable Az cmdlet.
Para migrar uma rede virtual com um gateway de aplicativo, remova o gateway antes de executar uma operação de preparação para mover a rede. Depois de concluir a migração, reconecte o gateway no Azure Resource Manager.
Verifique se você instalou os módulos clássico e Az do Azure PowerShell localmente no seu computador. Para obter mais informações, confira Como instalar e configurar o Azure PowerShell.
Não é possível migrar automaticamente gateways do Azure ExpressRoute que se conectam a circuitos de ExpressRoute em outra assinatura. Nesses casos, remova o gateway de ExpressRoute, migre a rede virtual e recrie o gateway.

Cenários com suporte

Os seguintes cenários com suporte para uma migração clássica para o Resource Manager:

Redes Virtuais clássicas que contêm máquinas virtuais.
Redes Virtuais clássicas com um conjunto de disponibilidade por serviço de nuvem no máximo.
Redes Virtuais Clássicas que contêm o Microsoft Entra Domain Services.
Redes Virtuais clássicas com um único gateway VPN ou um único circuito de Rota Expressa.

Cenários sem suporte

Os seguintes cenários não têm suporte para migração:

Gerenciando o ciclo de vida de uma rede virtual a partir do modelo de implantação clássico.
Suporte de controle de acesso baseado em função do Azure para o modelo de implantação clássico.
Migração de Rede Virtual com o gateway de ExpressRoute e gateway de VPN.
Migração de Redes Virtuais com mais de um conjunto de disponibilidade em um único serviço de nuvem.
Migração de Redes Virtuais com um ou mais conjuntos de disponibilidade e máquinas virtuais que não estão em um conjunto de disponibilidade em um único serviço de nuvem.
Migração de gateway de aplicativo do clássico para o Resource Manager.

Registrar provedor de recursos

Nesta seção, você entrará em sua assinatura usando os cmdlets do Resource Manager e registrará o provedor de recursos de migração.

Entre no Azure PowerShell:
```
Connect-AzAccount
```
Registre o provedor de recursos de migração:
```
Register-AzResourceProvider -ProviderNamespace Microsoft.ClassicInfrastructureMigrate
```
Aguarde cinco minutos para concluir o registro. Verifique o status do registro usando o seguinte comando:
```
Get-AzResourceProvider -ProviderNamespace Microsoft.ClassicInfrastructureMigrate
```
Verifique se RegistrationState é Registered antes de continuar.

Observação

O registro é uma etapa única, mas é preciso executá-lo uma vez antes de tentar a migração. Sem o registro, você verá a seguinte mensagem de erro:

BadRequest: a assinatura não está registrada para migração.

Recuperar o nome da rede virtual a ser migrado

Nesta seção, você entrará no modelo de implantação clássico do PowerShell e recuperará o nome da rede virtual a ser migrada.

Entre na implantação clássica do PowerShell:
```
Add-AzureAccount
```
Execute o seguinte comando para recuperar o nome clássico da rede virtual:
```
Get-AzureVnetSite | Select -Property Name
```

Anote o nome da rede virtual da próxima seção.

Migrar a rede virtual

Nesta seção, você validará se a migração pode continuar e preparar a migração.

Coloque o nome da rede virtual que você anotou na seção anterior em uma variável para uso pelos comandos. Substitua myVNet pelo nome da rede virtual recuperada na seção anterior:
```
$vnetname = "myVNet"
```
Validar pode migrar a rede virtual usando o seguinte comando:
```
Move-AzureVirtualNetwork -Validate -VirtualNetworkName $vnetName
```
O comando exibirá quaisquer avisos ou erros que bloqueiem a migração. Se a validação for bem-sucedida, prossiga com a seguinte etapa de preparação.

Observação

Se a rede virtual contiver funções Web ou de trabalho ou máquinas virtuais com configurações sem suporte, você receberá uma mensagem de erro de validação.
Execute o seguinte comando para preparar a rede virtual para migração:
```
Move-AzureVirtualNetwork -Prepare -VirtualNetworkName $vnetName
```
Se você não estiver pronto para a migração e desejar voltar para o estado anterior, use o comando a seguir:
```
Move-AzureVirtualNetwork -Abort -VirtualNetworkName $vnetName
```

Confirme a migração

Se tudo estiver bem na configuração preparada, você poderá confirmada a migração executando o seguinte comando:

Move-AzureVirtualNetwork -Commit -VirtualNetworkName $vnetName

Próximas etapas

Para obter mais informações sobre como migrar recursos no Azure do clássico para o Resource Manager, consulte:

Compartilhar via