Compartilhar via


Comando upgrade (winget)

O comando upgrade da ferramenta winget atualiza o aplicativo especificado. Opcionalmente, você pode usar o comando list para identificar o aplicativo que deseja atualizar.

O comando upgrade requer que você especifique a cadeia de caracteres exata a ser atualizada. Se houver alguma ambiguidade, você deverá filtrar ainda mais o comando upgrade para um aplicativo exato.

Aliases

Os seguintes aliases estão disponíveis para esse comando:

  • atualizar

Uso

winget upgrade [[-q] <query> ...] [<options>]

Imagem dos argumentos do comando de upgrade

Argumentos

Os argumentos a seguir estão disponíveis.

Argumento Descrição
-q,--query A consulta usada para pesquisar um aplicativo.

Observação

O argumento da consulta é posicional. Não há suporte para sintaxe de estilo curinga. Geralmente, essa é a cadeia de caracteres que você espera que ajude a encontrar o pacote que você está atualizando.

Opções

As opções permitem que você personalize a experiência de upgrade para atender às suas necessidades.

Opção Descrição
-m, --manifest Deve ser seguido pelo caminho para o arquivo de manifesto (YAML). É possível usar o manifesto para executar a experiência de upgrade de um arquivo YAML local.
--id Limita o upgrade à ID do aplicativo.
--name Limita a pesquisa ao nome do aplicativo.
--moniker Limita a pesquisa ao moniker listado para o aplicativo.
-v, --version Permite que você especifique uma versão exata a ser atualizada. Se ela não for especificada, a mais recente atualizará o aplicativo com versão mais alta.
-s, --source Restringe a pesquisa ao nome de origem fornecido. Deve ser seguido pelo nome de origem.
-e, --exact Usa a cadeia de caracteres exata na consulta, incluindo a verificação da diferenciação de maiúsculas e minúsculas. Ele não usará o comportamento padrão de uma substring.
-i, --interactive Executa o instalador no modo interativo. A experiência padrão mostra o progresso do instalador.
-h, --silent Executa o instalador no modo sem confirmação. Isso suprime todas as interfaces do usuário. A experiência padrão mostra o progresso do instalador.
--purge Exclui todos os arquivos e diretórios no diretório do pacote (portátil)
-o, --log Direciona o log a um arquivo de log. É necessário fornecer um caminho para um arquivo ao qual você tem direitos de gravação.
--custom Argumentos a serem passados para o instalador, além dos padrões.
--override Uma cadeia de caracteres que será passada diretamente para o instalador.
-l, --location Local para upgrade (se houver suporte).
--scope Selecione o filtro de escopo do pacote instalado (usuário ou computador).
a, --architecture Seleciona a arquitetura a ser instalada.
--installer-type Selecione o tipo de instalador que será atualizado. Consulte os tipos de instalador com suporte para o cliente WinGet.
--locale Especifica qual localidade deve ser usada (formato BCP47).
--ignore-security-hash Ignore a falha de verificação de hash do instalador. Não recomendado.
--allow-reboot Permite uma reinicialização, se aplicável.
--skip-dependencies Ignora o processamento de dependências de pacotes e recursos do Windows.
--ignore-local-archive-malware-scan Ignore a verificação de malware executada como parte da instalação de um pacote de tipo de arquivo morto do manifesto local.
--accept-package-agreements Usado para aceitar o contrato de licença e evitar o prompt.
--accept-source-agreements Usado para aceitar o contrato de licença de origem e evitar o prompt.
--header O cabeçalho HTTP de origem REST opcional Windows-Package-Manager.
--authentication-mode Especifique a preferência da janela de autenticação (silent, silentPreferred ou interactive).
--authentication-account Especifique a conta a ser usada para autenticação.
-r, --recurse, --all Atualize todos os pacotes instalados para a versão mais recente, se disponível.
-u, --unknown, --include-unknown Atualiza pacotes mesmo que a versão atual deles não possa ser determinada.
--pinned,--include-pinned Atualize os pacotes mesmo se eles tiverem um pino sem bloqueio.
--uninstall-previous Desinstale a versão anterior do pacote durante a atualização. O comportamento dependerá do pacote individual. Alguns instaladores são projetados para instalar novas versões lado a lado. Alguns instaladores incluem um manifesto que especifica "uninstallPrevious" para que as versões anteriores sejam desinstaladas sem a necessidade de usar esse sinalizador de comando. Nesse caso, a utilização do comando winget upgrade --uninstall-previous instruirá o WinGet a desinstalar a versão anterior, independentemente do que estiver no manifesto do pacote. Se o manifesto do pacote não incluir "uninstallPrevious" e o sinalizador --uninstall-previous não for usado, o comportamento padrão do instalador será aplicado.
--force Executa o comando diretamente e continua com problemas não relacionados à segurança.
-?,--help Mostra a ajuda sobre o comando selecionado.
--wait Solicita que o usuário pressione qualquer tecla antes de sair.
--logs,--open-logs Abre o local de logs padrão.
--verbose, --verbose-logs Usado para substituir a configuração de registro em log e criar um log detalhado.
--nowarn,--ignore-warnings Suprime as saídas de aviso.
--disable-interactivity Desabilitar prompts interativos.
--proxy Defina um proxy a ser usado para essa execução.
--no-proxy Desabilite o uso de proxy para essa execução.

Consultas de exemplo

O exemplo a seguir atualiza uma versão específica de um aplicativo.

winget upgrade powertoys --version 0.15.2

O exemplo a seguir atualiza um aplicativo por meio da ID dele.

winget upgrade --id Microsoft.PowerToys

O exemplo a seguir mostra a atualização de todos os aplicativos

winget upgrade --all

Como usar upgrade

Para identificar quais aplicativos precisam de uma atualização, basta usar upgrade sem argumentos para mostrar todas as atualizações disponíveis.

No exemplo abaixo, você verá que winget upgrade mostra ao usuário quais aplicativos têm uma atualização disponível. Nas atualizações disponíveis, o usuário identifica que uma atualização está disponível para JanDeDobbeleer.OhMyPosh e usa a upgrade para atualizar o aplicativo.

Animação que demonstra o comando upgrade

Como usar list e upgrade

Para pesquisar uma atualização disponível para um aplicativo específico, use o comando list. Depois de identificar que uma atualização está disponível para seu aplicativo específico, use upgrade para instalar o mais recente.

O exemplo a seguir mostra o comando list que está sendo usado para identificar se uma atualização está disponível para Microsoft.WindowsTerminalPreview. Em seguida, o usuário usa upgrade para atualizar o aplicativo. Animação demonstrando o comando list usado em conjunto com o comando upgrade

upgrade --all

upgrade --all identificará todas os aplicativos com upgrades disponíveis. Quando você executa winget upgrade --all, o Gerenciador de Pacotes do Windows procura todos os aplicativos que têm atualizações disponíveis e tentará instalá-las.

Observação

Alguns aplicativos não fornecem uma versão. Eles são sempre os mais recentes. Como o Gerenciador de Pacotes do Windows não pode identificar se há uma versão mais recente do aplicativo, uma atualização não será possível.

upgrade --uninstall-previous

upgrade --uninstall-previous desinstalará a versão anterior antes de instalar a versão mais recente do pacote. Ao usar --uninstall-previous, o comportamento dependerá do pacote individual. Alguns instaladores são projetados para instalar novas versões lado a lado, enquanto outros instaladores incluem um manifesto que especifica uninstallPrevious como comportamento de atualização padrão (portanto, as versões anteriores são desinstaladas sem a necessidade de usar o sinalizador de comando).

Se o manifesto do pacote não incluir uninstallPrevious como o comportamento de atualização e o sinalizador --uninstall-previous não for usado com o comando de atualização, será aplicado comportamento padrão do instalador.