Migrar uma Rede Virtual do Azure do clássico para o Gerenciador de Recursos usando o Azure PowerShell

Artigo
10/18/2023

Neste artigo, você aprenderá como 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 de cada 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 de 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. Os endereços IP públicos associados à rede virtual não são alterados durante o processo de migração.

Quando a migração for concluída, todas as operações de gerenciamento deverão ser executadas usando o modelo do 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 recursos de rede virtual ou de sub-rede não estarão mais disponíveis por meio do modelo de implantação antigo.

Quando você migra a rede virtual do modelo clássico para o Resource Manager, os recursos suportados dentro da rede virtual são migrados automaticamente para o novo modelo.

Pré-requisitos

Uma conta do Azure com uma subscrição ativa. Crie um gratuitamente.
As etapas e exemplos neste artigo usam o módulo Az do Azure PowerShell. Para instalar os módulos Az localmente no seu computador, consulte Instalar o Azure PowerShell. Para saber mais sobre o novo módulo Az, consulte 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 podem falhar. Para localizar as versões instaladas do PowerShell em seu sistema, use o cmdlet Get-Module -ListAvailable Az.
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 Gerenciador de Recursos do Azure.
Verifique se você instalou os módulos clássico e Az Azure PowerShell localmente em seu computador. Para obter mais informações, veja How to install and configure Azure PowerShell (Como instalar e configurar o Azure PowerShell).
Os gateways de Rota Expressa do Azure que se conectam a circuitos de Rota Expressa em outra assinatura não podem ser migrados automaticamente. Nesses casos, remova o gateway da Rota Expressa, migre a rede virtual e recrie o gateway.

Cenários suportados

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

Redes Virtuais Clássicas contendo 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 os Serviços de Domínio Microsoft Entra.
Redes Virtuais Clássicas com um único gateway VPN ou um único circuito de Rota Expressa.

Cenários não suportados

Os seguintes cenários não são suportados 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 gateway ExpressRoute e gateway VPN.
Migração de Redes Virtuais com mais de uma disponibilidade definida 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 do gateway de aplicativo do clássico para o Gerenciador de Recursos.

Registar o fornecedor de recursos

Nesta seção, você entrará em sua assinatura usando os cmdlets do Gerenciador de Recursos 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 que o registo termine. Verifique o status do registro usando o seguinte comando:
```
Get-AzResourceProvider -ProviderNamespace Microsoft.ClassicInfrastructureMigrate
```
Certifique-se de que RegistrationState está Registered antes de prosseguir.

Nota

O registro é uma etapa única, mas você deve fazê-lo uma vez antes de tentar a migração. Sem se registrar, 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 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 para a próxima seção.

Migrar a rede virtual

Nesta seção, você validará se a migração pode prosseguir e, em seguida, 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"
```
Valide se você pode migrar a rede virtual executando o seguinte comando:
```
Move-AzureVirtualNetwork -Validate -VirtualNetworkName $vnetName
```
O comando exibirá todos os avisos ou erros que bloqueiam a migração. Se a validação for bem-sucedida, você pode prosseguir com a seguinte etapa de preparação.

Nota

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 quiser voltar ao estado antigo, use o seguinte comando:
```
Move-AzureVirtualNetwork -Abort -VirtualNetworkName $vnetName
```

Confirmar a migração

Se tudo parecer bom na configuração preparada, você poderá confirmar a migração executando o seguinte comando:

Move-AzureVirtualNetwork -Commit -VirtualNetworkName $vnetName

Próximos passos

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

Partilhar via