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.
Questo articolo descrive come aggiornare i moduli di Azure PowerShell (Az) in Automazione di Azure. Il modulo Az PowerShell è un set di cmdlet per la gestione delle risorse di Azure direttamente da PowerShell. Automazione di Azure fornisce di default moduli PowerShell comuni in ogni account Automation. Per maggiori informazioni, vedi Moduli predefiniti. Man mano che il team Azure aggiorna regolarmente i moduli Azure, le modifiche possono verificarsi con i cmdlet inclusi. Ad esempio, rinominare un parametro o deprecare completamente un cmdlet. Questi cambiamenti possono influire sui runbook esistenti e sui processi di automazione se i moduli non vengono aggiornati adeguatamente. Per aiutare a gestire questi aggiornamenti, Automazione di Azure fornisce due metodi per aggiornare i moduli di Az Automation:
Nota
Non è possibile eliminare i moduli globali, ovvero i moduli forniti automaticamente da Automazione.
Importante
La nuova esperienza dell'ambiente di runtime consente di gestire moduli e pacchetti consentendo di configurare l'ambiente di esecuzione del processo. Nella nuova esperienza, i pannelli Moduli e pacchetti non sono disponibili. Per gestire moduli e pacchetti, vedere Gestire l'ambiente di runtime e i runbook associati.
Configurare un account di Automazione
Per evitare conseguenze sui runbook e sui processi che vengono automatizzati, assicurarsi di eseguire test e convalide prima di procedere con gli aggiornamenti. Se non è disponibile un account di Automazione dedicato a questo scopo, è consigliabile crearne uno in modo da poter testare numerosi scenari diversi durante lo sviluppo dei runbook. Questi test devono includere le modifiche iterative, ad esempio l'aggiornamento dei moduli di PowerShell.
Verificare che l'account di Automazione abbia aggiunto un'identità gestita assegnata dal sistema o un'identità gestita assegnata dall'utente.
Se si sviluppano gli script in locale, è consigliabile avere in locale le stesse versioni del modulo usate nell'account di Automazione durante i test, per assicurarsi di ottenere gli stessi risultati. Dopo che i risultati sono stati convalidati e hai applicato eventuali modifiche necessarie, puoi spostare le modifiche in produzione.
Nota
Un nuovo account di automazione potrebbe non contenere i moduli più recenti.
Aggiornare i moduli Az
Le sezioni seguenti spiegano come aggiornare i moduli di Az sia tramite il portale (consigliato) sia tramite il runbook.
Aggiorna i moduli di Az tramite il portale Azure
Attualmente, l'aggiornamento dei moduli Az è disponibile solo tramite il portale. Aggiornamenti tramite PowerShell e il modello di Resource Manager saranno disponibili in futuro. Solo i moduli Az predefiniti verranno aggiornati quando si eseguono i passaggi seguenti:
Accedere al portale di Azure e andare all'account di automazione.
In Risorse condivise selezionare Moduli.
Selezionare Aggiorna moduli Az.
Selezionare Modulo da aggiornare. Per impostazione predefinita, mostra il modulo Az.
Dal menu a tendina, seleziona Versione del Modulo e Versione Runtime.
Seleziona Aggiorna per aggiornare il modulo Az alla versione che hai selezionato. Nella pagina Moduli è possibile visualizzare l'elenco come illustrato di seguito:
Se si seleziona una versione inferiore a quella del modulo Az esistente importata nell'account di Automazione, l'operazione di aggiornamento eseguirà un rollback alla versione inferiore selezionata.
È possibile verificare l'operazione di aggiornamento controllando la proprietà relativa alla versione e allo stato del modulo dei moduli aggiornati visualizzati nell'elenco dei moduli in Moduli di PowerShell.
Il team di Azure aggiorna regolarmente la versione del modulo e offre un'opzione per aggiornare i moduli Az predefiniti selezionando la versione del modulo dalla lista a tendina.
Aggiornare i moduli Az tramite i runbook
Per aggiornare i moduli Azure nell'account di Automazione:
- Usare il runbook Update-AutomationAzureModulesForAccount, disponibile come open source.
- Scaricare dal repository GitHub per iniziare a usare questo runbook per aggiornare i moduli di Azure.
- Importarlo nell'account di Automazione o eseguirlo come script. Per informazioni su come importare un runbook nell'account di Automazione, vedere Importare un runbook.
Nota
È consigliabile aggiornare i moduli Az tramite Azure portale. È anche possibile eseguire questa operazione usando lo script Update-AutomationAzureModulesForAccount, disponibile come open source e fornito come riferimento. Tuttavia, in caso di errore del runbook, è necessario modificare i parametri nel runbook in base alle esigenze o eseguire il debug dello script in base allo scenario.
Il runbook Update-AutomationAzureModulesForAccount supporta l'aggiornamento dei moduli Azure, AzureRM e Az per impostazione predefinita. Per altre informazioni sull'aggiornamento di Az, vedere Update Azure modules runbook README. Moduli di automazione utilizzati con questo runbook. Ci sono altri fattori importanti di cui devi tenere conto quando utilizzi i moduli Az nel tuo account di Automazione. Per altre informazioni, vedere Gestisci moduli in Automazione di Azure.
Usare il codice del runbook di aggiornamento come normale script di PowerShell
È possibile usare il codice del runbook come un normale script di PowerShell invece di un runbook. Per farlo, accedi ad Azure usando prima il cmdlet Connect-AzAccount, poi passa -Login $false allo script.
Usare il runbook di aggiornamento nei cloud sovrani
Per usare questo runbook nei cloud sovrani, usare il parametro AzEnvironment per passare l'ambiente corretto al runbook. I valori accettabili sono AzureCloud (Azure cloud pubblico), AzureChinaCloud, AzureGermanCloud e AzureUSGovernment. Puoi recuperare questi valori usando Get-AzEnvironment | select Name. Se non si passa un valore a questo cmdlet, il runbook usa per impostazione predefinita AzureCloud.
Usare il runbook di aggiornamento per aggiornare una specifica versione del modulo
Se si vuole usare una versione del modulo Azure PowerShell specifica anziché il modulo più recente disponibile nella PowerShell Gallery, passare queste versioni al parametro facoltativo ModuleVersionOverrides del runbook Update-AutomationAzureModulesForAccount. Per esempio, vedere il runbook Update-AutomationAzureModulesForAccount.ps1. Azure PowerShell moduli non menzionati nel parametro ModuleVersionOverrides vengono aggiornati con le versioni più recenti del modulo nella PowerShell Gallery. Se non si passa nulla al parametro ModuleVersionOverrides, tutti i moduli vengono aggiornati con le versioni più recenti del modulo nella PowerShell Gallery. Questo comportamento è lo stesso per il pulsante Update Azure Modules nel portale di Azure.
Passaggi successivi
- Per dettagli sull'uso dei moduli, vedi Gestire i moduli in Automazione di Azure.
- Per informazioni sul runbook di aggiornamento, vedere Update Azure modules runbook.
- Per la risoluzione dei problemi relativi all'aggiornamento di moduli Azure PowerShell gestiti come risorse condivise in Automazione di Azure, vedere Risoluzione dei problemi relativi alle risorse condivise Automazione di Azure.