Aggiornare i moduli Azure PowerShell in Automazione

I moduli più comuni di Azure PowerShell vengono forniti per impostazione predefinita in ogni account di Automazione. Vedere Moduli predefiniti. Man mano che il team Azure aggiorna regolarmente i moduli Azure, le modifiche possono verificarsi con i cmdlet inclusi. Queste modifiche, ad esempio la ridenominazione di un parametro o la deprecazione completa di un cmdlet, possono influire negativamente sui runbook.

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 aver convalidato i risultati e applicato le modifiche necessarie, è possibile spostare le modifiche in produzione.

Aggiornare i moduli Az

Le sezioni seguenti illustrano come aggiornare i moduli Az tramite il portale (scelta consigliata) o tramite il runbook.

Aggiornare i moduli Az tramite il portale

L'aggiornamento dei moduli AZ è attualmente disponibile solo tramite il portale. Aggiornamenti tramite PowerShell e ARM (Azure Resource Manager) saranno disponibili in futuro. Solo i moduli Az predefiniti verranno aggiornati quando si eseguono i passaggi seguenti:

1. Accedere al portale Azure portale e passare all'account di Automazione.

2. In Risorse condivise selezionare Moduli.

3. Selezionare Aggiorna moduli Az.

4. Selezionare Modulo da aggiornare. Per impostazione predefinita, verrà visualizzato il modulo Az.

5. Nell'elenco a discesa selezionare Versione del modulo e Versione tipo di esecuzione.

6. Selezionare Aggiorna per aggiornare il modulo Az alla versione selezionata. 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 Azure aggiornerà regolarmente la versione del modulo e fornirà un'opzione per aggiornare i moduli default Az selezionando la versione del modulo dall'elenco a discesa.

Aggiornare i moduli Az tramite i runbook

Per aggiornare i moduli Azure nell'account di Automazione:

1. Usare il runbook Update-AutomationAzureModulesForAccount, disponibile come open source.
2. Scaricare dal repository GitHub per iniziare a usare questo runbook per aggiornare i moduli di Azure.
3. Importarlo nell'account di Automazione o eseguirlo come script. Per informazioni su come importare un runbook nell'account di Automazione, vedere Importare un runbook.

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. Esistono altri fattori importanti da tenere in considerazione quando si usano i moduli Az nell'account di Automazione. Per altre informazioni, vedere Gestisci moduli in Azure Automation.

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. A tale scopo, accedere prima a Azure usando il cmdlet Connect-AzAccount e quindi passare prima -Login $false allo script.

Usare il runbook di aggiornamento sui cloud sovrani

Per utilizzare questo runbook nei cloud sovrani, utilizzare il parametro AzEnvironment per passare l'ambiente corretto nel runbook. I valori accettabili sono AzureCloud (Azure cloud pubblico), AzureChinaCloud, AzureGermanCloud e AzureUSGovernment. Questi valori possono essere recuperati tramite 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 informazioni dettagliate sull'uso dei moduli, vedere Gestisci moduli in Azure Automation.
• 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 Azure Automation, vedere Risoluzione dei problemi relativi alle risorse condivise Azure Automation.