Partilhar via

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 é mais mantido ou suportado, 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 PowerShell do AzureRM

Use o seguinte comando para determinar se você tem o módulo do PowerShell do AzureRM 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 do PowerShell do AzureRM.

Atualizar para o módulo do Az PowerShell

Os scripts gravados 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 do AzureRM para o Az. Nenhuma migração para um novo conjunto de comandos é conveniente, mas este artigo ajudará você a começar a fazer a transição para o módulo do Az PowerShell. Para saber mais sobre por que o módulo do Az PowerShell foi criado, consulte Apresentando o módulo do 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 cmdlet, use Az. Por exemplo, o cmdlet antigo New-AzureRMVm foi transformado em 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 versão mais recente do AzureRM

Antes de executar as etapas 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 informe 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 ú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 seus scripts não funcionarem com o AzureRM 6.13.2, atualize-os de acordo com o guia de migração AzureRM 5.x para 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 Az, você pode gerar um plano para determinar quais alterações serão executadas em seus scripts antes de fazer modificações neles e antes de instalar o módulo do Az 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 Enable-AzureRmAlias

O módulo Az tem um modo de compatibilidade para ajudá-lo a usar 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 modificação mínima enquanto trabalha para uma migração completa para o Az. Por padrão, Enable-AzureRmAlias habilita apenas os aliases de compatibilidade para a sessão atual do PowerShell. Use seu parâmetro Scope para persistir aliases de compatibilidade em 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á descontinuado com a descontinuação do módulo do PowerShell do AzureRM.

Próximas etapas