Eseguire la migrazione di Azure PowerShell da AzureRM ad Az

  • Articolo

Avviso

Il modulo AzureRM PowerShell è stato ufficialmente deprecato a partire dal 29 febbraio 2024. È consigliabile eseguire la migrazione da AzureRM al modulo Az PowerShell per garantire il supporto e gli aggiornamenti continui.

Anche se il modulo AzureRM può ancora funzionare, non è più gestito o supportato, posizionando qualsiasi uso continuo a discrezione e rischio dell'utente. Per indicazioni sulla transizione al modulo Az, vedere le risorse di migrazione.

Determinare se si usa il modulo AzureRM PowerShell

Usare il comando seguente per determinare se è installato il modulo AzureRM PowerShell:

Get-Module -Name AzureRM -ListAvailable

È anche possibile eseguire una ricerca full-text degli script per il modello *-AzureRM* per determinare se uno di essi usa il modulo AzureRM PowerShell.

Eseguire l'aggiornamento al modulo Az PowerShell

Gli script scritti per i cmdlet di AzureRM non funzioneranno automaticamente con Az. Per semplificare la transizione, è stato sviluppato il toolkit di migrazione da AzureRM ad Az. Per quanto nessuna migrazione a un nuovo set di comandi sia immediata, questo articolo consentirà di iniziare la transizione al modulo Az PowerShell. Per altre informazioni sul motivo per cui è stato creato il modulo Az PowerShell, vedere Introduzione al modulo Az PowerShell.

I nuovi nomi dei cmdlet sono stati progettati per essere facili da imparare. Invece di usare AzureRm o Azure nei nomi dei cmdlet, usare Az. Ad esempio, il vecchio cmdlet New-AzureRMVm è diventato New-AzVm. Tuttavia, la migrazione è più che acquisire familiarità con i nuovi nomi di cmdlet. sono presenti altre importanti modifiche, tra cui moduli e parametri rinominati.

Per visualizzare l'elenco completo delle modifiche di rilievo tra AzureRM e Az, vedere Modifiche di rilievo della migrazione da AzureRM ad Az.

Verificare il funzionamento degli script esistenti con l'ultima versione di AzureRM

Prima di eseguire qualsiasi procedura di migrazione, determinare le versioni di AzureRM installate nel sistema. In questo modo è possibile assicurarsi che gli script siano già in esecuzione nella versione più recente e di comunicare quali versioni di AzureRM devono essere disinstallate.

Per determinare le versioni di AzureRM installate, eseguire l'esempio seguente:

Get-Module -Name AzureRM -ListAvailable -All

La versione più recente disponibile di AzureRM è la 6.13.2. Se questa versione non è installata, per poter usare gli script esistenti con il modulo Az, può essere necessario apportare altre modifiche che esulano dall'ambito di questo articolo e dell'elenco di modifiche di rilievo.

Se gli script non funzionano con AzureRM 6.13.2, aggiornarli in base alla guida alla migrazione da AzureRM 5.x a 6.x. Se si usa una versione precedente del modulo AzureRM, sono disponibili guide alla migrazione per ogni versione principale.

Questa opzione consigliata riduce al minimo gli interventi richiesti per la migrazione degli script di AzureRM ad Az.

Grazie al toolkit di migrazione da AzureRM ad Az, è possibile generare un piano per determinare quali modifiche verranno eseguite sugli script prima di apportare modifiche agli script e prima di installare il modulo Az PowerShell.

L'avvio rapido Eseguire automaticamente la migrazione degli script di PowerShell dal modulo AzureRM al modulo Az PowerShell illustra in modo dettagliato l'intero processo di aggiornamento automatico degli script di PowerShell dal modulo AzureRM al modulo Az PowerShell.

Opzione 2: Usare la modalità di compatibilità con Enable-AzureRmAlias

Il modulo Az offre una modalità compatibilità che consente di usare gli script esistenti mentre esegue l'aggiornamento alla nuova sintassi. Il cmdlet Enable-AzureRmAlias abilita una modalità di compatibilità tramite alias. Questa modalità consente di usare gli script esistenti con modifiche minime mentre si procede alla migrazione completa ad Az. Per impostazione predefinita, Enable-AzureRmAlias abilita solo gli alias di compatibilità per la sessione corrente di PowerShell. Usare il parametro Scope per salvare in modo permanente gli alias di compatibilità nelle sessioni di PowerShell. Per altre informazioni, vedere la documentazione di riferimento di Enable-AzureRmAlias.

Importante

Anche se sono stati creati alias per i nomi dei cmdlet, possono esistere comunque parametri nuovi o rinominati oppure valori restituiti modificati per i cmdlet di Az. Non aspettarsi che l'abilitazione degli alias si occupi automaticamente della migrazione. Per individuare le parti degli script che potrebbero richiedere aggiornamenti, vedere l'elenco completo delle modifiche di rilievo.

Il supporto per Enable-AzureRmAlias non verrà deprecato con la deprecazione del modulo AzureRM PowerShell.

Passaggi successivi