Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Avvertimento
Il modulo AzureRM PowerShell è stato ufficialmente deprecato a partire dal 29 febbraio 2024. Agli utenti è consigliato migrare da AzureRM al modulo Az PowerShell per garantire supporto e aggiornamenti continui.
Anche se il modulo AzureRM può ancora funzionare, non è più gestito né supportato, pertanto qualsiasi uso continuato è a discrezione e rischio dell'utente. Si prega di fare riferimento alle nostre risorse di migrazione per avere una guida sulla transizione verso il modulo Az.
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 . 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 New-AzureRMVm precedente è diventato New-AzVm.
Tuttavia, la migrazione è più che 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 le modifiche complete 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 è la 6.13.2. Se questa versione non è installata, gli script esistenti potrebbero richiedere modifiche aggiuntive per usare il modulo Az oltre l'ambito di quanto descritto in questo articolo e nell'elenco delle 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.
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 Eseguire automaticamente la migrazione degli 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 Scope parametro 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. Vedere l'elenco completo delle modifiche che causano un'interruzione per trovare dove gli script potrebbero richiedere aggiornamenti.
Il supporto per Enable-AzureRmAlias non verrà deprecato con la deprecazione del modulo AzureRM PowerShell.
Passaggi successivi
Collabora con noi su GitHub
L'origine di questo contenuto è disponibile in GitHub, in cui è anche possibile creare ed esaminare i problemi e le richieste pull. Per ulteriori informazioni, vedere la guida per i collaboratori.
