Como atualizar a CLI do Azure

Você pode contar com gerenciadores de pacotes para atualizar uma instalação local da CLI do Azure em ambientes Windows, macOS e Linux (consulte a seção Update 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

Começando com a versão 2.11.0, a CLI do Azure fornece um comando na ferramenta para atualizar para a versão mais recente.

az upgrade

Esse comando também atualiza todas as extensões instaladas por padrão. Para obter mais opções de az upgrade, consulte a página de referência do comando . Para versões da CLI do Azure antes do 2.11.0, atualize reinstalando conforme descrito em Instalar a CLI do Azure.

az upgrade tem suporte no Windows, macOS e algumas distribuições do Linux, desde que haja suporte para a instalação. Ele só dá suporte à atualização para a versão mais recente. Se você estiver executando a CLI do Azure por meio do Azure Cloud Shell, provavelmente já está usando a instalação mais recente da CLI do Azure. Se não for devido a casos como o lançamento ad hoc de uma versão de correção de bug menor, você precisará aguardar a próxima compilação do Azure Cloud Shell, pois não há suporte para az upgrade no Azure Cloud Shell.

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

Atualização automática

Por padrão, o autoupgrade da CLI do Azure está desativado. Se você quiser acompanhar a versão mais recente, poderá habilitar a atualização automática por meio da configuração .

az config set auto-upgrade.enable=yes

A CLI do Azure verificará as novas versões regularmente e solicitará que você atualize depois que qualquer comando terminar de ser executado quando a atualização estiver disponível.

A mensagem de prompt e as mensagens de saída durante a atualização podem interromper o resultado do comando se ele for atribuído a alguma variável ou em um fluxo automatizado. Para evitar a interrupção, você pode usar a configuração a seguir 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 padrão, todas as extensões instaladas também são atualizadas. Você pode desabilitar a atualização de extensão por meio da configuração.

az config set auto-upgrade.all=no

Nota

Aguarde a conclusão az upgrade antes de prosseguir para o próximo conjunto de comandos, caso contrário, as novas versões da CLI (+extensões) podem ter alterações significativas.

Se você decidir não usar mais o recurso de atualização automática para casos como manter scripts de comando em execução de forma estável, poderá desativá-lo por meio da configuração.

az config set auto-upgrade.enable=no