Come aggiornare l'interfaccia della riga di comando di Azure

Per aggiornare un'installazione locale dell'interfaccia della riga di comando di Azure in ambienti Windows, macOS e Linux, è possibile usare utilità di gestione pacchetti. Vedere la sezione Update nelle istruzioni di installazione specifiche di ogni piattaforma. L'interfaccia della riga di comando include anche comandi predefiniti per l'aggiornamento manuale o automatico.

Aggiornamento manuale

L'interfaccia della riga di comando include un comando predefinito per eseguire l'aggiornamento all'ultima versione:

az upgrade

Nota

Il comando az upgrade è stato aggiunto nella versione 2.11.0 e non funziona con le versioni precedenti alla 2.11.0. Le versioni precedenti possono essere aggiornate reinstallando come descritto in Installare l'interfaccia della riga di comando di Azure.

Per impostazione predefinita, questo comando aggiorna anche tutte le estensioni installate. Per altre opzioni di az upgrade, vedere la pagina di informazioni di riferimento sui comandi.

az upgrade è supportato in Windows, in macOS e in alcune distribuzioni Linux, purché l'installazione sia supportata. Supporta solo l'aggiornamento alla versione più recente. Se l'interfaccia della riga di comando di Azure viene eseguita tramite Azure Cloud Shell, è molto probabile che si usi già l'installazione più recente. In caso contrario, ad esempio se si tratta di un rilascio ad hoc di una versione secondaria per la correzione di bug, è necessario aspettare la build successiva di Azure Cloud Shell, perché az upgrade non è supportato in Azure Cloud Shell.

Se azure-cli è già la versione più recente, l'esecuzione di az upgrade verificherà e aggiornerà tutte le estensioni installate.

Aggiornamento automatico

Per impostazione predefinita, l'aggiornamento dell'interfaccia della riga di comando di Azure è disabilitato. Per tenersi al passo con l'ultima versione, è possibile abilitare l'aggiornamento automatico tramite configurazione.

az config set auto-upgrade.enable=yes

L'interfaccia della riga di comando di Azure controllerà regolarmente la presenza di nuove versioni e, quando è disponibile l'aggiornamento, chiederà di eseguirlo al termine dell'esecuzione di eventuali comandi.

Il messaggio di richiesta e i messaggi di output durante l'aggiornamento potrebbero interrompere il risultato di un comando se è assegnato a qualche variabile o è incluso in un flusso automatizzato. Per evitare interruzioni, è possibile usare la configurazione seguente per consentire l'esecuzione automatica dell'aggiornamento senza conferma e visualizzare solo avvisi ed errori durante la procedura.

az config set auto-upgrade.prompt=no

Per impostazione predefinita, vengono aggiornate anche tutte le estensioni installate. È possibile disabilitare l'aggiornamento delle estensioni tramite configurazione.

az config set auto-upgrade.all=no

Nota

Attendere che az upgrade venga completato prima di procedere al set successivo di comandi, altrimenti le nuove versioni dell'interfaccia della riga di comando (oltre alle estensioni) potrebbero introdurre modifiche che causano interruzioni.

Se si decide di non usare più la funzionalità di aggiornamento automatico, ad esempio per mantenere la stabilità dell'esecuzione degli script dei comandi, è possibile disattivarla tramite configurazione.

az config set auto-upgrade.enable=no