Come aggiornare la CLI 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 integrati 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 eseguire l'aggiornamento alla versione più recente.

az upgrade

Per impostazione predefinita, questo comando aggiorna anche tutte le estensioni installate. Per altre az upgrade opzioni, vedere la pagina di riferimento del comando. Per le versioni dell'interfaccia della riga di comando di Azure precedenti alla versione 2.11.0, eseguire l'aggiornamento 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 più recente dell'interfaccia della riga di comando di Azure. Se non a causa del rilascio ad hoc di una versione minore per la correzione di bug, è necessario attendere la build successiva di Azure Cloud Shell poiché az upgrade non è supportata in Azure Cloud Shell.

Quando azure-cli è già la versione più recente, eseguire az upgrade controlli e aggiornare tutte le estensioni installate.

Aggiornamento automatico

Per impostazione predefinita, l'aggiornamento automatico per l'interfaccia della riga di comando di Azure è disabilitato. Se si vuole mantenere il passo con la versione più recente, è possibile abilitare il downgrade automatico 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 di 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 confermare e visualizzare solo avvisi ed errori durante l'aggiornamento.

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 per casi come mantenere gli script di comando in esecuzione stabilmente, è possibile disattivarla tramite la configurazione.

az config set auto-upgrade.enable=no