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 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 nos seus scripts com 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, o Kit de Ferramentas de Migração de AzureRM para Az foi desenvolvido. 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 se familiarizar 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 o 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 você não tiver esta versão instalada, seus scripts existentes podem precisar de modificações adicionais para trabalhar com o módulo Az além do escopo do que é descrito neste artigo e na lista de alterações de quebra de .

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 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 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 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 habilitação de aliases cuide da migração para você. Consulte a lista completa de alterações de interrupções para encontrar onde os seus scripts podem exigir atualizações.

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

Próximos passos