Migrar o Azure PowerShell do AzureRM para o Az

  • Artigo

Aviso

O módulo PowerShell do AzureRM foi oficialmente preterido a partir de 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo do Az PowerShell para garantir o suporte e as atualizações contínuas.

Embora o módulo AzureRM ainda possa funcionar, ele não tem suporte ou será mantido, colocando qualquer uso contínuo a critério e risco do usuário. Consulte nossos recursos de migração para obter diretrizes sobre a transição para o módulo Az.

Determinar se você está usando o módulo do AzureRM PowerShell

Use o seguinte comando para determinar se você tem o módulo do AzureRM PowerShell instalado:

Get-Module -Name AzureRM -ListAvailable

Faça também uma pesquisa de texto completo dos scripts em busca do padrão *-AzureRM* para determinar se algum deles está usando o módulo do AzureRM PowerShell.

Atualizar para o módulo do Az PowerShell

Os scripts gravados para os cmdlets do AzureRM não funcionarão automaticamente no 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, mas este artigo ajudará você a começar a realizar a transição para o módulo Az do PowerShell. Para saber mais sobre o motivo da criação do módulo Az PowerShell, confira Apresentação do módulo Az PowerShell.

Os novos nomes de cmdlets foram projetados para serem fáceis de aprender. Em vez de usar AzureRm ou Azure nos nomes de cmdlets, use Az. Por exemplo, o cmdlet antigo New-AzureRMVm tornou-se New-AzVm. Contudo, a migração vai além do que se familiarizar com os novos nomes de cmdlets. Há módulos e parâmetros renomeados, além de outras alterações importantes.

Para ver a lista completa de alterações da falha entre o AzureRM e o Az, confira as alterações completas do AzureRM para o Az.

Verifique se os scripts existentes funcionam com a última versão do AzureRM

Antes de executar qualquer etapa de migração, determine 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 determinar quais versões do AzureRM você instalou, execute o seguinte exemplo:

Get-Module -Name AzureRM -ListAvailable -All

A última versão disponível do AzureRM é a 6.13.2. Se você não tiver essa versão instalada, os scripts existentes poderão precisar de modificação adicional para funcionar com o módulo Az, além do escopo descrito neste artigo e na lista de alterações da falha.

Se os scripts não funcionarem com o AzureRM 6.13.2, atualize-os de acordo com o guia de migração do AzureRM 5.x para o 6.x. Se você usar uma versão anterior do módulo AzureRM, haverá guias de migração disponíveis para cada versão principal.

Essa opção recomendada minimiza o esforço necessário para migrar scripts do AzureRM para o Az.

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.

O início rápido Migrar automaticamente os scripts do PowerShell do AzureRM para o módulo Az do PowerShell orienta você ao longo do processo inteiro de atualização automática dos scripts do PowerShell do AzureRM para o módulo Az do PowerShell.

Opção 2: Usar o modo de compatibilidade com o cmdlet Enable-AzureRmAlias

O módulo Az tem um modo de compatibilidade para ajudá-lo a usar os scripts existentes enquanto você atualiza para a nova sintaxe. O cmdlet Enable-AzureRmAlias habilita um modo de compatibilidade por meio de aliases. Esse modo permite que você use scripts existentes com o mínimo de modificações, ao passo que trabalha no sentido de uma migração completa para o Az. Por padrão, Enable-AzureRmAlias habilita apenas aliases de compatibilidade para a sessão atual do PowerShell. Use seu parâmetro Scope para persistir os aliases de compatibilidade entre as sessões do PowerShell. Para obter mais informações, confira a documentação de referência de Enable-AzureRmAlias.

Importante

Embora os nomes dos cmdlets sejam convertidos em alias, ainda poderá haver parâmetros novos (ou renomeados) ou valores retornados alterados para os cmdlets do Az. Não espere que a habilitação de aliases cuide da migração para você. Confira a lista completa de alterações da falha para descobrir quando seus scripts podem exigir atualizações.

O suporte para Enable-AzureRmAlias não será preterido com a substituição do módulo AzureRM PowerShell.

Próximas etapas