Condividi tramite


Panoramica del modulo Az.Tools.Migration di PowerShell

Il modulo Az.Tools.Migration di PowerShell facilita la transizione dal modulo AzureRM precedente al modulo Az più recente, consigliato per la gestione di Azure.

Importante

Il modulo AzureRM PowerShell è deprecato a partire dal 29 febbraio 2024.

Microsoft ha introdotto Az.Tools.Migration in risposta al feedback dei clienti, in particolare per quanto riguarda l'impegno richiesto per aggiornare gli script originariamente scritti per AzureRM. Riconoscendo che molti clienti hanno investito nella creazione di script complessi per gli ambienti Di Azure, Az.Tools.Migration è stato creato per semplificare e automatizzare il processo di migrazione, riducendo così il carico di lavoro manuale e il potenziale errore durante gli aggiornamenti dello script.

Come usare il modulo Az.Tools.Migration

Il processo di utilizzo di Az.Tools.Migration prevede diversi passaggi:

  1. Aggiornamento ad AzureRM versione 6.13.1: prima di usare Az.Tools.Migration, gli utenti devono assicurarsi che gli script vengano aggiornati ad AzureRM versione 6.13.1, l'ultima versione prima della migrazione al modulo Az .

  2. Installazione di Az.Tools.Migration: il modulo può essere installato da PowerShell Gallery con il Install-Module -Name Az.Tools.Migration comando .

  3. Generazione di un piano di aggiornamento: il New-AzUpgradeModulePlan cmdlet genera un piano di aggiornamento. Non modifica gli script esistenti, ma fornisce un percorso di aggiornamento creando un piano che descrive in dettaglio file specifici e punti di offset che richiedono aggiornamenti. Questo cmdlet accetta parametri come FilePath e DirectoryPath per specificare script o cartelle specifici.

  4. Revisione del piano di aggiornamento: prima di eseguire l'aggiornamento, è fondamentale esaminare il piano per eventuali problemi che potrebbero impedire gli aggiornamenti automatici, ad esempio i comandi che usano lo splatting e correggerli manualmente, se necessario.

  5. Esecuzione dell'aggiornamento: dopo aver esaminato e risolto eventuali problemi, l'aggiornamento effettivo viene eseguito usando il Invoke-AzUpgradeModulePlan cmdlet . Questo cmdlet può modificare i file esistenti o, in modo più sicuro, salvare le modifiche ai nuovi file con _az_upgraded i nomi aggiunti ai relativi nomi per mantenere gli script originali.

Per garantire una migrazione senza problemi, è consigliabile eseguire il backup degli script prima di eseguire gli aggiornamenti perché il Invoke-AzUpgradeModulePlan cmdlet può essere distruttivo se non usato con l'opzione -FileEditMode SaveChangesToNewFiles .

Gli utenti sono invitati a fornire commenti e suggerimenti o segnalare problemi con il processo di migrazione nel repository GitHub per azure-powershell-migration.