Migrar o Azure PowerShell do AzureRM para o 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 completa 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, o kit de ferramentas de migração do AzureRM para o Az foi desenvolvido. 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 Introdução ao 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 New-AzureRMVm antigo tornou-se New-AzVm. No entanto, a migração está mais do que se familiarizar com os novos nomes de cmdlet. Há módulos, parâmetros e outras alterações importantes renomeada.

Para ver a lista completa de alterações interruptivas 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 versão mais recente disponível do AzureRM é 6.13.2. Se você não tiver essa versão instalada, os scripts existentes poderão precisar de modificações adicionais para trabalhar com o módulo Az além do escopo do que está 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, haverá guias de migração disponíveis para cada versão principal.

Opção 1 (recomendado): migrar automaticamente seus scripts do PowerShell

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.

A migração automática de scripts do PowerShell do AzureRM para o início rápido do módulo do Az PowerShell explica 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 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 Scope parâmetro para persistir aliases de compatibilidade em sessões do PowerShell. Para obter mais informações, consulte a documentação de referência do Enable-AzureRmAlias.

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

Próximas etapas

• Migrar scripts do PowerShell automaticamente
• Apresentando o módulo do Az PowerShell
• Alterações entre o AzureRM e o Az
• Instalar o módulo do Az PowerShell
• Desinstalar o AzureRM