Visão geral do módulo Az.Tools.Migration do PowerShell

  • Artigo

O módulo Az.Tools.Migration do PowerShell facilita a transição do módulo AzureRM mais antigo para o módulo Az mais recente, que é recomendado para o gerenciamento do Azure.

Importante

O módulo AzureRM PowerShell foi preterido a partir de 29 de fevereiro de 2024.

A Microsoft introduziu o Az.Tools.Migration em resposta aos comentários dos clientes, particularmente sobre o esforço necessário para atualizar scripts que foram originalmente escritos para o AzureRM. Reconhecendo que muitos clientes investiram na criação de scripts complexos para ambientes do Azure, o Az.Tools.Migration foi criado para simplificar e automatizar o processo de migração, reduzindo assim a carga de trabalho manual e o potencial de erro durante as atualizações de script.

Como usar o módulo Az.Tools.Migration

O processo de uso do Az.Tools.Migration envolve várias etapas:

  1. Atualização para o AzureRM versão 6.13.1: antes de usar o Az.Tools.Migration, os usuários devem garantir que seus scripts sejam atualizados para o AzureRM versão 6.13.1, a última versão antes da migração para o módulo Az.

  2. Instalação do Az.Tools.Migration: o módulo pode ser instalado da Galeria do PowerShell com o comando Install-Module -Name Az.Tools.Migration.

  3. Geração de um plano de atualização: o cmdlet New-AzUpgradeModulePlan gera um plano de atualização. Ele não altera scripts existentes, mas fornece um caminho de atualização criando um plano detalhando arquivos específicos e pontos de deslocamento que exigem atualizações. Esse cmdlet usa parâmetros como FilePath e DirectoryPath para direcionar scripts ou pastas específicos.

  4. Revisão do Plano de Atualização: antes de executar a atualização, é crucial examinar o plano para possíveis problemas que possam impedir atualizações automáticas, como comandos que usam fracionamento, e corrigi-los manualmente, se necessário.

  5. Executar a atualização: depois de examinar e resolver quaisquer problemas, a atualização real é executada usando o cmdlet Invoke-AzUpgradeModulePlan. Esse cmdlet pode modificar arquivos existentes ou, com mais segurança, salvar alterações em novos arquivos acrescentando _az_upgraded a seus nomes para preservar os scripts originais.

Para garantir uma migração tranquila, é recomendável fazer backup de scripts antes de executar atualizações, pois o cmdlet Invoke-AzUpgradeModulePlan pode ser destrutivo se não for usado com a opção -FileEditMode SaveChangesToNewFiles.

Os usuários são incentivados a fornecer comentários ou relatar problemas com o processo de migração no repositório do GitHub para azure-powershell-migration.