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

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 do PowerShell do AzureRM 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. Atualizando 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. Instalando o Az.Tools.Migration: O módulo pode ser instalado na 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 ajuste que exigem atualizações. Esse cmdlet usa parâmetros como FilePath e DirectoryPath para direcionar scripts ou pastas específicos.

4. Revisando o Plano de Atualização: Antes de executar a atualização, é crucial examinar o plano para quaisquer possíveis problemas 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 examinar 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 acrescentados _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 Invoke-AzUpgradeModulePlan cmdlet 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 GitHub para azure-powershell-migration.