Eseguire la migrazione di Azure PowerShell da AzureRM ad Az
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 è ancora in funzione, non è più gestito o supportato, pertanto ogni uso continuato è a discrezione e rischio dell'utente. Per indicazioni sulla transizione al modulo Az, vedere le risorse di migrazione.
Determinare se si sta usando il modulo AzureRM PowerShell
Determinare se si sta usando 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.
Aggiornare il 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 sui motivi per cui il modulo Az PowerShell è stato creato, vedere Introduzione del modulo di Azure 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.
La migrazione, tuttavia, non implica solo di acquisire familiarità con i nuovi nomi dei 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 i passaggi di migrazione, determinare quali versioni di AzureRM sono installate nel sistema. In questo modo è possibile assicurarsi che gli script siano già in esecuzione nella versione più recente, oltre a identificare le versioni di AzureRM da disinstallare.
Per determinare quali versioni di AzureRM sono state installate, eseguire questo esempio:
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 alle indicazioni della guida alla migrazione di AzureRM dalla versione 5.x alla versione 6.x. Se si usa una versione precedente del modulo AzureRM, sono disponibili guide alla migrazione per ogni versione principale.
Opzione 1 (scelta consigliata): eseguire automaticamente la migrazione degli script di PowerShell
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. Tenere presente che l'abilitazione degli alias non implica l'esecuzione automatica 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.