Como atualizar a CLI do Azure

Pode contar com os gestores de pacotes para atualizar uma instalação local da CLI do Azure em ambientes Windows, macOS e Linux (consulte a Update secção em cada instrução de instalação específica da plataforma). A CLI também fornece comandos na ferramenta para atualizar manual ou automaticamente.

Atualização Manual

A partir da versão 2.11.0, a CLI do Azure fornece um comando na ferramenta para atualizar para a versão mais recente.

az upgrade

Este comando também atualiza todas as extensões instaladas por predefinição. Para obter mais az upgrade opções, veja a página de referência de comandos. Para versões da CLI do Azure anteriores à versão 2.11.0, atualize ao reinstalar conforme descrito em Instalar a CLI do Azure.

az upgrade é suportado no Windows, macOS e algumas distribuições do Linux, desde que a instalação seja suportada. Suporta apenas a atualização para a versão mais recente. Se estiver a executar a CLI do Azure através do Azure Cloud Shell, é provável que já esteja a utilizar a instalação mais recente da CLI do Azure. Se não for devido a casos como a versão ad-hoc de uma versão de correção de erros secundária, terá de aguardar pela próxima compilação do Azure Cloud Shell, tal como az upgrade não é suportada no Azure Cloud Shell.

Quando azure-cli já é a versão mais recente, a execução de az upgrade verificações e atualiza todas as extensões instaladas.

Atualização Automática

Por predefinição, a atualização automática da CLI do Azure está desativada. Se quiser acompanhar a versão mais recente, pode ativar a atualização automática através da configuração.

az config set auto-upgrade.enable=yes

A CLI do Azure verificará regularmente as novas versões e pedir-lhe-á que atualize depois de concluir a execução de qualquer comando assim que a atualização estiver disponível.

A mensagem de pedido e as mensagens de saída durante a atualização podem interromper o resultado do comando se estiver atribuído a alguma variável ou num fluxo automatizado. Para evitar interrupções, pode utilizar a seguinte configuração para permitir que a atualização ocorra automaticamente sem confirmação e mostrar apenas avisos e erros durante a atualização.

az config set auto-upgrade.prompt=no

Por predefinição, todas as extensões instaladas também são atualizadas. Pode desativar a atualização da extensão através da configuração.

az config set auto-upgrade.all=no

Nota

Aguarde até az upgrade concluir antes de avançar para o próximo conjunto de comandos, caso contrário, as novas versões da CLI (+extensões) poderão ter alterações interruptivas.

Se decidir deixar de utilizar a funcionalidade de atualização automática para casos como manter os scripts de comandos em execução de forma estável, pode desativá-la através da configuração.

az config set auto-upgrade.enable=no