Como atualizar o Azure CLI

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

Atualização manual

O CLI fornece um comando in-tool para atualizar para a versão mais recente:

az upgrade

Nota

O az upgrade comando foi adicionado na versão 2.11.0 e não funcionará com versões antes do 2.11.0. As versões mais antigas podem ser atualizadas reinstalando-se conforme descrito na Instalação do Azure CLI.

Este comando também atualizará todas as extensões instaladas por padrão. Para mais az upgrade opções, consulte a página de referência do comando.

az upgrade é suportado em Windows, macOS e alguns distros Linux enquanto a instalação for suportada. Só suporta o upgrade para a versão mais recente. Se estiver a executar o Azure CLI através do Azure Cloud Shell, é provável que já esteja a utilizar a mais recente instalação do Azure CLI. Se não for devido a casos como o lançamento ad-hoc de uma versão de correção de bugs menores, terá de esperar pela próxima construção do Azure Cloud Shell como az upgrade não é suportado no Azure Cloud Shell.

Quando azure-cli já for a versão mais recente, a execução az upgrade verificará e atualizará todas as extensões instaladas.

Atualização Automática

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

az config set auto-upgrade.enable=yes

O CLI Azure verificará regularmente novas versões e solicitar-lhe-á a atualização após qualquer acabamento de comando em execução assim que a atualização estiver disponível.

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

az config set auto-upgrade.prompt=no

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

az config set auto-upgrade.all=no

Nota

Por favor, aguarde az upgrade que esteja concluído antes de avançar para o próximo conjunto de comandos, caso contrário as novas versões do CLI (+extensões) poderão ter alterações de rutura.

Se decidir não utilizar mais a funcionalidade de atualização automática para casos como manter os scripts de comando a funcionar de forma espetada, pode desligá-lo através da configuração.

az config set auto-upgrade.enable=no