Eseguire la migrazione di Azure PowerShell da AzureRM ad Az
Avvertimento
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 AzureRM to Az migration Toolkit. Non è mai utile eseguire la migrazione a un nuovo set di comandi, ma questo articolo consente di iniziare a eseguire 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. Anziché usare AzureRm o Azure nei nomi dei cmdlet, usare Az. Ad esempio, il cmdlet precedente New-AzureRMVm è diventato New-AzVm.
Tuttavia, la migrazione non consiste solo nell'acquisire familiarità con i nuovi nomi di cmdlet. Sono stati rinominati moduli, parametri e altre modifiche importanti.
Per visualizzare l'elenco completo delle modifiche di rilievo tra AzureRM e Az, vedere i cambiamenti completi da AzureRM ad Az.
Assicurarsi che gli script esistenti funzionino con la versione più recente 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 è 6.13.2. Se questa versione non è installata, gli script esistenti potrebbero richiedere modifiche aggiuntive per funzionare con il modulo Az oltre l'ambito di quanto descritto in questo articolo e nell'elenco delle modifiche che causano interruzioni .
Se gli script non funzionano con AzureRM 6.13.2, aggiornarli in base al 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.
Opzione 1 (scelta consigliata): eseguire automaticamente la migrazione degli script di PowerShell
Questa opzione consigliata riduce al minimo lo sforzo necessario per eseguire la migrazione di script AzureRM ad Az.
Con il toolkit di migrazione da AzureRM ad Az, è possibile generare un piano per determinare quali modifiche verranno eseguite negli script prima di apportare modifiche e prima di installare il modulo Az PowerShell.
La guida introduttiva Migrare automaticamente gli script di PowerShell da AzureRM al modulo Az PowerShell illustra l'intero processo di aggiornamento automatico degli script di PowerShell da AzureRM al modulo Az PowerShell.
Opzione 2: Usare la modalità di compatibilità con Enable-AzureRmAlias
Il modulo Az ha una modalità di compatibilità che consente di usare gli script esistenti durante 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 durante la migrazione completa ad Az. Per impostazione predefinita, Enable-AzureRmAlias abilita solo gli alias di compatibilità per la sessione di PowerShell corrente. Usare il parametro Scope per rendere persistenti gli alias di compatibilità tra le sessioni di PowerShell. Per altre informazioni, vedere la documentazione di riferimento Enable-AzureRmAlias.
Importante
Anche se i nomi dei cmdlet sono alias, potrebbero essere ancora presenti parametri nuovi (o rinominati) o valori restituiti modificati per i cmdlet Az. Non aspettarsi che l'abilitazione degli alias si occupi automaticamente della migrazione. Consulta l'elenco completo delle modifiche significative per trovare dove gli script potrebbero richiedere aggiornamenti.
Il supporto per Enable-AzureRmAlias non verrà deprecato con la deprecazione del modulo AzureRM PowerShell.
