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

A partire dalla versione 2.11.0, l'interfaccia della riga di comando di Azure fornisce un comando in-tool per aggiornare alla versione più recente.

az upgrade

Questo comando aggiorna anche tutte le estensioni installate per impostazione predefinita. Per altre az upgrade opzioni, vedere la pagina di riferimento ai comandi. Per le versioni dell'interfaccia della riga di comando di Azure precedenti alla versione 2.11.0, aggiornare reinstallando come descritto in Installare l'interfaccia della riga di comando di Azure.

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 si esegue l'interfaccia della riga di comando di Azure tramite Azure Cloud Shell, è probabile che si stia già usando l'installazione dell'interfaccia della riga di comando di Azure più recente. Se non a causa di casi come la versione ad hoc di una versione di correzione di bug secondaria, è necessario attendere la successiva compilazione di Azure Cloud Shell come az upgrade non è supportata in Azure Cloud Shell.

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

Aggiornamento automatico

Per impostazione predefinita, l'opzione autoupgrade per l'interfaccia della riga di comando di Azure è disabilitata. Se si vuole mantenere la versione più recente, è possibile abilitare autoupgrade tramite la 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 del prompt e i messaggi di output durante l'aggiornamento possono interrompere il risultato del comando se è assegnato a una variabile o 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 l'aggiornamento.

az config set auto-upgrade.prompt=no

Per impostazione predefinita, tutte le estensioni installate vengono aggiornate anche. È 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 per i casi come mantenere gli script di comando in esecuzione in modo stabilmente, è possibile disattivarlo tramite la configurazione.

az config set auto-upgrade.enable=no