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:
Use uma MSA (Conta Microsoft), uma conta de trabalho, de estudo ou do AAD (Azure Active Directory) para se inscrever no Canal do Desenvolvedor do Windows Insider.
Use uma MSA (Conta Microsoft) para se inscrever no Programa Insiders do Gerenciador de Pacotes do Windows.
Instale o pacote do Instalador de Aplicativo da Área de Trabalho do Windows localizado na Página de versões do repositório do WinGet. A instalação desse pacote fornecerá a você o cliente WinGet, mas não habilitará as atualizações automáticas da Microsoft Store.
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.
Para pesquisar uma ferramenta, digite
winget search <appname>.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.
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.
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: