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 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 efetuar uma pesquisa de texto completo dos seus scripts para o padrão *-AzureRM*, para 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 toolkit 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 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 é 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 das alterações interruptivas entre o AzureRM e o Az, veja todas as alterações do AzureRM para o 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 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 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 os 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 para migrar automaticamente os scripts do PowerShell do AzureRM para o módulo do Az PowerShell orienta o utilizador por todo o processo de atualização automática dos seus 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 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 padrão, Enable-AzureRmAlias habilita apenas 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

Mesmo que os nomes dos cmdlets tenham alias, ainda pode haver parâmetros novos (ou renomeados) ou valores de retorno alterados para os cmdlets do Az. Não espere que a ativação de aliases resolva a migração por si só. 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