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

  • Artigo

O módulo Az.Tools.Migration 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 em relação ao 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 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 utilização do Az.Tools.Migration envolve várias etapas:

  1. Atualizando para o AzureRM versão 6.13.1: Antes de usar 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. Instalando Az.Tools.Migration: O módulo pode ser instalado a partir da Galeria do PowerShell com o Install-Module -Name Az.Tools.Migration comando.

  3. Gerando um plano de atualização: o New-AzUpgradeModulePlan cmdlet 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 revisar o plano para quaisquer problemas potenciais que possam impedir atualizações automáticas, como comandos que usam splatting, e corrigi-los manualmente, se necessário.

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

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

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