Como atualizar a CLI do Azure

Você pode confiar nos 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

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, consulte a página de referência do comando. Para versões da CLI do Azure anteriores à 2.11.0, atualize reinstalando conforme descrito em Instalar a CLI do Azure.

az upgrade é suportado no Windows, macOS e algumas distribuições Linux, desde que a instalação seja suportada. Ele só suporta a 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á esperar pela próxima compilação do Azure Cloud Shell, pois az upgrade não é suportado no Azure Cloud Shell.

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

Atualização automática

Por padrão, a atualização automática para a CLI do Azure está desabilitada. Se tu quiseres manter-te atualizado com a versão mais recente, podes ativar a atualização automática através da configuração .

az config set auto-upgrade.enable=yes

A CLI do Azure verificará novas versões regularmente e solicitará que você atualize depois que qualquer comando terminar de ser executado assim que 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 interrupção, você pode usar a seguinte configuração para permitir que a atualização aconteça 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 desativar a atualização de extensão através da configuração.

az config set auto-upgrade.all=no

Observação

Por favor, aguarde a conclusão de az upgrade antes de avançar para o próximo conjunto de comandos; caso contrário, as novas versões da CLI (+extensões) podem ter mudanças disruptivas.

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

az config set auto-upgrade.enable=no