Migrar o Azure PowerShell do AzureRM para o Az

  • Artigo

Aviso

O módulo AzureRM PowerShell 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 Az PowerShell para garantir suporte e atualizações contínuos.

Embora o módulo AzureRM ainda possa funcionar, ele não é mais mantido ou suportado, colocando qualquer uso continuado a critério e risco do usuário. Consulte nossos recursos de migração para obter orientação sobre a transição para o módulo Az.

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

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

Get-Module -Name AzureRM -ListAvailable

Você também pode executar uma pesquisa de texto completo de seus scripts para o padrão *-AzureRM* para determinar se algum deles está usando o módulo AzureRM PowerShell.

Atualizar para o módulo Az PowerShell

Os scripts escritos para os cmdlets do AzureRM não irão funcionar automaticamente com o Az. Para facilitar a transição, foi desenvolvido o toolkit de migração do AzureRM para o Az. Uma migração para um novo conjunto de comandos nunca é conveniente, mas este artigo ajuda-o a fazer a transição para o módulo Az PowerShell. Para saber mais sobre por que o módulo Az PowerShell foi criado, consulte Apresentando o módulo Az PowerShell.

Os novos nomes de cmdlet foram criados para serem fáceis de aprender. Em vez de utilizar AzureRm ou Azure em nomes de cmdlet, utilize Az. Por exemplo, o cmdlet antigo New-AzureRMVm tornou-se New-AzVm. No entanto, a migração está mais do que se familiarizando com os novos nomes de cmdlet. Existem módulos com nomes alterados, parâmetros e outras alterações importantes.

Para ver a lista completa das alterações interruptivas entre o AzureRM e o Az, veja todas as alterações do AzureRM para o Az.

Certifique-se de que os scripts existentes funcionam com a versão mais recente do AzureRM

Antes de executar qualquer etapa de migração, determine quais versões do AzureRM estão instaladas em seu sistema. Isso permite que você verifique se os scripts já estão em execução na versão mais recente e informa quais versões do AzureRM devem ser desinstaladas.

Para determinar quais versões do AzureRM você instalou, execute o seguinte exemplo:

Get-Module -Name AzureRM -ListAvailable -All

A versão mais recente disponível do AzureRM é 6.13.2. Se não tiver esta versão instalada, os seus scripts existentes poderão precisar de modificações adicionais para funcionar com o módulo Az para além do âmbito do que foi descrito neste artigo e na lista de alterações interruptivas.

Se seus 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 6.x. Se utilizar uma versão anterior do módulo AzureRM, existem guias de migração disponíveis para cada versão principal.

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

Com o toolkit de migração do AzureRM para o Az, pode gerar um plano para determinar que alterações serão executadas nos scripts antes de fazer quaisquer modificações aos mesmos e antes de instalar o módulo Az PowerShell.

O início rápido Migrar automaticamente os scripts do PowerShell do AzureRM para o módulo Az PowerShell orienta-o pelo processo completo de atualizar automaticamente os scripts do PowerShell do AzureRM para o módulo Az PowerShell.

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

O módulo Az tem um modo de compatibilidade para o ajudar a utilizar os scripts existentes enquanto atualiza para a nova sintaxe. O cmdlet Enable-AzureRmAlias ativa um modo de compatibilidade através de aliases. Este modo permite-lhe utilizar scripts existentes com modificações mínimas e trabalhar, ao mesmo tempo, no sentido de uma migração completa para o Az. Por predefinição, o Enable-AzureRmAlias só permite aliases de compatibilidade para a sessão atual do PowerShell. Utilize o respetivo parâmetro Scope para persistir os aliases de compatibilidade entre as sessões do PowerShell. Para obter mais informações, veja a documentação de referência de Enable-AzureRmAlias.

Importante

Embora os nomes dos cmdlets tenham aliases, poderá continuar a existir parâmetros novos (ou com nome alterado) ou valores de retorno alterados dos cmdlets do Az. Não espere que a habilitação de aliases cuide da migração para você. Veja a lista completa de alterações interruptivas para saber onde os seus scripts poderão precisar de atualizações.

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

Próximos passos