Usar a ferramenta winget para instalar e gerenciar aplicativos

A ferramenta de linha de comando winget permite que os usuários descubram, instalem, atualizem, removam e configurem aplicativos em computadores com Windows 10 e Windows 11. Essa ferramenta é a interface do cliente para o serviço Gerenciador de Pacotes do Windows.

Instalar o winget

A ferramenta de linha de comando WinGet do Gerenciador de Pacotes do Windows vem no pacote do Windows 11 e das versões modernas do Windows 10 por padrão como o Instalador de Aplicativo.

Se você estiver executando uma versão anterior do Windows e o Instalador de Aplicativo não estiver instalado, obtenha o Instalador de Aplicativo na Microsoft Store. Se ele já estiver instalado, verifique se está atualizado com a versão mais recente.

O Instalador de Aplicativo inclui a versão de produção da ferramenta winget.

Observação

A ferramenta de linha de comando winget só tem suporte no Windows 10 1709 (build 16299) ou posterior neste momento.

Instalar a versão prévia do winget [Somente para desenvolvedores]

Para experimentar os recursos mais recentes do Gerenciador de Pacotes do Windows, instale a compilação de pré-visualização da ferramenta de linha de comando winget por meio de uma das seguintes maneiras:

Considerações sobre o administrador

O comportamento do instalador poderá ser diferente dependendo se você estiver executando o winget com privilégios de administrador.

  • Ao executar o winget sem privilégios de administrador, alguns aplicativos podem exigir elevação para serem instalados. Quando o instalador for executado, o Windows solicitará que você eleve. Se você optar por não elevar, o aplicativo não será instalado.

  • Ao executar o winget em um Prompt de Comando de Administrador, você não verá prompts de elevação se o aplicativo os exigir. Sempre tome cuidado ao executar o prompt de comando como administrador e instale apenas aplicativos confiáveis.

Usar o winget

Depois que o Instalador de Aplicativo estiver instalado, será possível executar o winget digitando "winget" em um Prompt de Comando.

Um dos cenários de uso mais comuns é pesquisar e instalar uma ferramenta favorita.

  1. Para pesquisar uma ferramenta, digite winget search <appname>.

  2. Depois de confirmar que a ferramenta que você deseja está disponível, será possível instalá-la digitando winget install <appname>. A ferramenta winget iniciará o instalador e instalará o aplicativo em seu computador. Linha de comandos do winget

  3. Além de instalar e pesquisar, winget fornece vários outros comandos que permitem que você mostre detalhes sobre aplicativos, altere fontes e validade pacotes. Para obter uma lista completa de comandos, digite: winget --help. Ajuda do winget

Alguns usuários relataram problemas com o cliente, que não estava em seu PATH.

Comandos

A versão prévia atual da ferramenta winget dá suporte aos comandos a seguir.

Comando Descrição
install Instala o aplicativo especificado.
show Exibe os detalhes do aplicativo especificado.
source Adiciona, remove e atualiza os repositórios do Gerenciador de Pacotes do Windows acessados pela ferramenta winget.
search Pesquisa um aplicativo.
list Exibir os pacotes instalados.
upgrade Atualiza o pacote determinado.
uninstall Desinstala o pacote determinado.
hash Gera o hash SHA256 para o instalador.
validate Valida um arquivo de manifesto para envio ao repositório do Gerenciador de Pacotes do Windows.
configurações Abrir as configurações.
recursos Mostra o status dos recursos experimentais.
export Exporta uma lista dos pacotes instalados.
import Instala todos os pacotes em um arquivo.

Opções

A ferramenta winget dá suporte às seguintes opções.

Opção Descrição
-v, --version Retorna a versão atual do WinGet.
--info Fornece todas as informações detalhadas sobre o winget, incluindo os links para a licença e a política de privacidade, além das políticas de grupo configuradas.
-?, --help Mostra ajuda adicional para o WinGet.

Formatos de instalador com suporte

A ferramenta winget dá suporte aos seguintes tipos de instaladores:

  • EXE (com sinalizadores Silent e SilentWithProgress)
  • INNO
  • NULLSOFT
  • MSI
  • APPX
  • MSIX
  • BURN
  • PORTABLE

Winget de script

É possível criar scripts em lote e do PowerShell para instalar vários aplicativos.

@echo off  
Echo Install Powertoys and Terminal  
REM Powertoys  
winget install Microsoft.Powertoys  
if %ERRORLEVEL% EQU 0 Echo Powertoys installed successfully.  
REM Terminal  
winget install Microsoft.WindowsTerminal  
if %ERRORLEVEL% EQU 0 Echo Terminal installed successfully.   %ERRORLEVEL%

Observação

Quando tiver script, o winget iniciará os aplicativos na ordem especificada. Quando um instalador retornar êxito ou falha, o winget iniciará o próximo instalador. Se um instalador iniciar outro processo, será possível que ele retorne ao winget prematuramente. Isso fará o winget instalar o próximo instalador antes que o instalador anterior tenha sido concluído.

Depuração e solução de problemas

O winget fornece registro em log para ajudar a diagnosticar problemas. Para solução de problemas e detalhes sobre o registro em log, confira Depuração e solução de problemas.

Ferramentas ausentes

Se o repositório da comunidade não incluir sua ferramenta ou aplicativo, envie um pacote para o nosso repositório. Ao adicionar sua ferramenta favorita, ela estará disponível para você e todos os outros.

Personalizar configurações de WinGet

Você pode configurar a experiência de linha de comando WinGet modificando o arquivo settings.json. Para obter mais informações, consulte https://aka.ms/winget-settings. Observe que as configurações ainda estão em um estado experimental e não foram finalizadas para a versão prévia da ferramenta.

Detalhes do software livre

A ferramenta winget é um software de código aberto disponível no GitHub no repositório https://github.com/microsoft/winget-cli/. A fonte para a criação do cliente está localizada na pasta src.

A fonte para winget está contida em uma solução em C++ do Visual Studio 2019. Para compilar a solução corretamente, instale a carga de trabalho mais recente do Visual Studio com o C++.

Incentivamos você a contribuir com a fonte do winget no GitHub. Primeiro, você deve concordar e assinar o CLA da Microsoft.

Solução de problemas

O repositório winget-cli mantém uma lista de problemas comuns e erros comuns, juntamente com recomendações sobre como resolvê-los: