Migrar o Azure PowerShell do AzureRM para o Azure
Os scripts criados para os cmdlets do AzureRM não funcionarão automaticamente com o novo módulo Az. Para facilitar a transição, foi desenvolvido o kit de ferramentas de migração do AzureRM para o Az. Nenhuma migração para um novo conjunto de comandos é conveniente sempre, mas é importante que você entenda como fazer a transição para o módulo Az do PowerShell.
Os novos nomes de cmdlets foram projetados para serem mais fáceis de aprender. Em vez de usar AzureRm ou o Azure em nomes de cmdlets, você usa cmdlets do Az. Por exemplo, o cmdlet antigo New-AzureRMVmtornou-se New-AzVm. Contudo, a migração é mais do que apenas se familiarizar com os novos nomes de cmdlets. Há módulos e parâmetros renomeados, além de outras alterações importantes.
Antes de executar qualquer etapa de migração, verifique quais versões do AzureRM estão instaladas em seu sistema. Esse procedimento permite que você verifique se os scripts já estão em execução na última versão e se você sabe quais versões do AzureRM precisam ser desinstaladas.
Para verificar qual versão do AzureRM foi instalada, execute o seguinte comando:
Get-Module -Name AzureRM -ListAvailable -All
Observação
A última versão disponível do AzureRM é a 6.13.1. Se você não tiver essa versão instalada, os scripts atuais poderão precisar de modificações adicionais para funcionar com o módulo Az.
A opção recomendada para a migração do AzureRM para o módulo Az do PowerShell é usar a migração automática. Para isso, você precisa instalar o kit de ferramentas de migração do AzureRM para oAz executando o seguinte comando:
Install-Module -Name Az.Tools.Migration
Com o kit de ferramentas de migração do AzureRM para o Az, você poderá gerar um plano para determinar quais alterações serão executadas nos scripts antes de fazer qualquer modificação neles e antes de instalar o módulo Az do PowerShell.
Leitura adicional: Para saber mais sobre as etapas de migração automática, consulte Início Rápido: migrar automaticamente scripts do PowerShell do AzureRM para o módulo Az do PowerShell.
Você também pode usar o Microsoft Visual Studio Code para migrar seus scripts atuais. Para fazer isso, primeiro você precisa instalar a extensão do Azure PowerShell para Visual Studio Code. Depois, você precisa executar as seguintes etapas:
- Carregue o script do AzureRM no Visual Studio Code.
- Abra a paleta de comandos selecionando Ctrl+Shift+P.
- Selecione o script Migrar Azure PowerShell.
- Selecione a versão de origem do AzureRM.
- Siga as ações recomendadas para cada comando ou parâmetro sublinhado.