upgrade Comando (winget)

O upgrade comando da winget ferramenta atualiza a aplicação especificada. Opcionalmente, pode usar o list comando para identificar a aplicação que pretende upgrade.

O upgrade comando exige que especifique a cadeia exata para upgrade. Se houver alguma ambiguidade, ser-se-á solicitado a filtrar ainda mais o upgrade comando para uma aplicação exata.

Apelidos

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

• update

Utilização

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

Argumentos

Estão disponíveis os seguintes argumentos.

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

Observação

O argumento de consulta é posicional. Não é suportada a sintaxe estilo curinga. Na maioria das vezes, esta é a sequência de caracteres que se espera para ajudar a encontrar o pacote que se está a atualizar.

Opções

As opções permitem-lhe personalizar a upgrade experiência para satisfazer as suas necessidades.

Opção	Descrição
-m, --manifest	Deve ser seguido pelo caminho para o ficheiro de manifesto (YAML). Podes usar o manifesto para executar a upgrade experiência a partir de um ficheiro YAML local.
--id	Limita o upgrade ao ID da aplicação.
--name	Limita a pesquisa ao nome do aplicativo.
--moniker	Limita a pesquisa ao apelido listado para o aplicativo.
-v, --version	Permite-lhe especificar uma versão exata para upgrade. Se não for especificado, o mais recente será upgrade a aplicação com a versão mais alta.
-s, --source	Restringe a pesquisa ao nome de origem fornecido. Deve ser seguido pelo nome da fonte.
-e, --exact	Usa a cadeia de caracteres exata na consulta, incluindo a verificação de 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 silencioso. Isso suprime toda a interface 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 registo para um ficheiro de log. Você deve fornecer um caminho para um arquivo para o qual tenha os 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	Localização para upgrade para (se suportado).
--scope	Selecione o filtro de escopo do pacote instalado (usuário ou máquina).
-a, --architecture	Selecione a arquitetura a ser instalada.
--installer-type	Selecione o tipo de instalação para upgrade. Consulte os tipos de instalador suportados para o cliente WinGet.
--locale	Especifica qual localidade usar (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 das dependências de pacotes e das funcionalidades do Windows.
--ignore-local-archive-malware-scan	Ignore a verificação de malware executada como parte da instalação de um pacote de tipo arquivo a partir do manifesto local.
--accept-package-agreements	Usado para aceitar o contrato de licença e evitar a mensagem de aviso.
--accept-source-agreements	Usado para aceitar o contrato de licença original e evitar o aviso.
--header	Cabeçalho HTTP de origem REST opcional para 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	Atualize os pacotes, mesmo que sua versão atual não possa ser determinada.
--pinned, --include-pinned	Atualize os pacotes mesmo que eles tenham um pino sem bloqueio.
--uninstall-previous	Desinstale a versão anterior do pacote durante upgrade. 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 versões anteriores sejam desinstaladas sem necessidade de usar este comando flag. Nesse caso, usar o comando winget upgrade --uninstall-previous vai indicar ao WinGet que deve proceder à desinstalação da versão anterior, independentemente do que está no manifesto do pacote. Se o manifesto do pacote não incluir "uninstallPrevious" e a --uninstall-previous flag não for utilizada, então o comportamento padrão para o instalador será aplicado.
--force	Execute de forma direta o comando e continue com questões não relacionadas à 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	Abra o local de logs padrão.
--verbose, --verbose-logs	Usado para anular a configuração de registo e criar um registo detalhado.
--nowarn, --ignore-warnings	Suprime mensagens de aviso.
--disable-interactivity	Desative os prompts interativos.
--proxy	Defina um proxy a ser usado para essa execução.
--no-proxy	Desative o uso de proxy para esta execução.

Exemplos de consultas

O exemplo seguinte lista aplicações com um upgrade disponível.

winget upgrade

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 a partir de sua ID.

winget upgrade --id Microsoft.PowerToys

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

winget upgrade --all

O exemplo seguinte terá upgrade múltiplas aplicações.

winget upgrade Microsoft.Edit Microsoft.NuGet

Ao utilizar upgrade

Para identificar quais as aplicações que precisam de um update, basta usar upgrade sem argumentos para mostrar todas as atualizações disponíveis.

upgrade --all

upgrade --all irá atualizar upgrade todas as aplicações instaladas que têm uma update disponível. Quando executas winget upgrade --all, o Windows Gestor de Pacotes procura todas as aplicações que tenham atualizações disponíveis e tenta instalá-las. Use upgrade primeiro sem quaisquer argumentos para pré-visualizar que aplicações serão atualizadas.

Observação

Alguns aplicativos não fornecem uma versão. São sempre mais recentes. Como o Windows Gestor de Pacotes não consegue identificar se existe uma versão mais recente da aplicação, an upgrade não será possível a menos que a -uopção , --unknown, --include-unknown seja especificada

Observação

Algumas aplicações podem ter sido fixadas usando WinGet e não serão atualizadas se a --all opção for especificada, a menos que a --include-pinned opção seja especificada. Nesse caso, serão atualizados apenas os pinos não bloqueantes das aplicações.

upgrade --uninstall-previous

upgrade --uninstall-previous Vou 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 concebidos para instalar novas versões lado a lado, enquanto outros incluem um ficheiro de manifesto que especifica uninstallPrevious como o seu comportamento upgrade predefinido (pelo que as versões anteriores são desinstaladas sem ser necessário usar a opção de comando).

Se o manifesto do pacote não incluir uninstallPrevious como o upgrade comportamento e a --uninstall-previous flag não for usada com o upgrade comando, então o comportamento padrão do instalador será aplicado.