Partilhar via

Migrar o Azure PowerShell do AzureRM para Az

  • Artigo

Advertência

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 os nossos recursos de migração para orientação na 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 realizar uma pesquisa de texto completo nos seus scripts para o padrão *-AzureRM*, a fim de determinar se algum deles está a usar o módulo AzureRM PowerShell.

Atualizar para o módulo Az PowerShell

Os scripts escritos para os cmdlets do AzureRM não funcionarão automaticamente com o Az. Para facilitar a transição, foi desenvolvido o kit de ferramentas de migração AzureRM para Az. Nenhuma migração para um novo conjunto de comandos é conveniente, mas este artigo ajudará você a começar 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 projetados para serem fáceis de aprender. Em vez de usar AzureRm ou Azure em nomes de cmdlets, use Az. Por exemplo, o cmdlet antigo New-AzureRMVm tornou-se New-AzVm. No entanto, a migração é mais do que apenas familiarizar-se com os novos nomes de cmdlet. Há módulos renomeados, parâmetros e outras alterações importantes.

Para ver a lista completa de alterações significativas entre AzureRM e Az, consulte as alterações completas de AzureRM para Az.

Garantir que os scripts existentes funcionem 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 podem necessitar de modificações adicionais para funcionar com o módulo Az, além do que está descrito neste artigo e na lista de alterações incompatíveis .

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 você usar uma versão anterior do módulo AzureRM, há guias de migração disponíveis para cada versão principal.

Esta 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 AzureRM para Az, você pode gerar um plano para determinar quais alterações serão executadas em seus scripts antes de fazer quaisquer modificações neles e antes de instalar o módulo Az PowerShell.

O guia de início rápido migrar automaticamente os scripts do PowerShell do AzureRM para o módulo do Az PowerShell orienta você por todo o processo de atualização automática dos scripts do PowerShell do AzureRM para o módulo do Az PowerShell.

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

O módulo Az tem um modo de compatibilidade para ajudá-lo a usar scripts existentes enquanto atualiza para a nova sintaxe. O cmdlet Enable-AzureRmAlias habilita um modo de compatibilidade por meio de aliases. Este modo permite que você use scripts existentes com modificações mínimas enquanto trabalha para 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 aliases de compatibilidade nas sessões do PowerShell. Para obter mais informações, consulte a documentação de referência Enable-AzureRmAlias.

Importante

Mesmo que os nomes dos cmdlets sejam transformados em aliases, ainda podem existir novos parâmetros (ou renomeados) ou valores de retorno alterados para os Az cmdlets. Não espere que a habilitação de aliases cuide da migração para você. Consulte a lista completa de alterações para encontrar onde os seus scripts podem exigir atualizações.

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

Próximos passos