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 está disponível no Windows 11 e em versões modernas do Windows 10 como parte do Instalador de Aplicativo.

É possível obter o Instalador de Aplicativo na Microsoft Store. Se ele já estiver instalado, verifique se está atualizado com a versão mais recente.

Observação

A ferramenta de linha de comando winget só tem suporte no Windows 10 1709 (build 16299) ou posterior neste momento. A ferramenta winget não estará disponível até que você tenha feito logon no Windows como usuário pela primeira vez, o que fará com que a Microsoft Store registre o Gerenciador de Pacotes do Windows como parte de um processo assíncrono. Se você tiver feito logon recentemente como usuário pela primeira vez e o winget ainda não estiver disponível, abra o PowerShell e insira o seguinte comando para solicitar o registro dele: Add-AppxPackage -RegisterByFamilyName -MainPackage Microsoft.DesktopAppInstaller_8wekyb3d8bbwe.

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

O WinGet está incluído no Instalador de Aplicativo do Windows. Para experimentar os recursos mais recentes do Gerenciador de Pacotes do Windows, você pode instalar uma compilação de pré-visualização de uma das seguintes maneiras:

  • Baixe a versão prévia mais recente do winget. Leia as Notas sobre a versão prévia do winget para saber mais sobre os novos recursos. A instalação desse pacote fornecerá a você o cliente WinGet, mas não habilitará as atualizações automáticas de novas versões prévias da Microsoft Store.

  • 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. O Canal do Desenvolvedor do Windows Insider inclui atualizações automáticas de novas versões prévias da Microsoft Store.

  • Use uma MSA (Conta Microsoft) para se inscrever no Programa Insiders do Gerenciador de Pacotes do Windows. Depois que sua MSA (Conta Microsoft) tiver sido adicionada (alguns dias após receber uma notificação por email), você receberá atualizações automáticas de novas versões prévias da Microsoft Store.

Instalar o winget na Área Restrita do Windows

A Área Restrita do Windows fornece um ambiente de área de trabalho leve para a execução segura e isolada de aplicativos. O software instalado no ambiente da Área Restrita do Windows permanece "em área restrita" e é executado separadamente do computador host. A Área Restrita do Windows não inclui winget nem o aplicativo da Microsoft Store, portanto, você precisará baixar o pacote winget mais recente na página de versões de winget no GitHub.

Para instalar a versão estável do winget na Área Restrita do Windows, siga estas etapas em um prompt de comando do Windows PowerShell:

$progressPreference = 'silentlyContinue'
Write-Information "Downloading WinGet and its dependencies..."
Invoke-WebRequest -Uri https://aka.ms/getwinget -OutFile Microsoft.DesktopAppInstaller_8wekyb3d8bbwe.msixbundle
Invoke-WebRequest -Uri https://aka.ms/Microsoft.VCLibs.x64.14.00.Desktop.appx -OutFile Microsoft.VCLibs.x64.14.00.Desktop.appx
Invoke-WebRequest -Uri https://github.com/microsoft/microsoft-ui-xaml/releases/download/v2.8.6/Microsoft.UI.Xaml.2.8.x64.appx -OutFile Microsoft.UI.Xaml.2.8.x64.appx
Add-AppxPackage Microsoft.VCLibs.x64.14.00.Desktop.appx
Add-AppxPackage Microsoft.UI.Xaml.2.8.x64.appx
Add-AppxPackage Microsoft.DesktopAppInstaller_8wekyb3d8bbwe.msixbundle

Se você quiser uma versão prévia ou diferente do Gerenciador de Pacotes, acesse https://github.com/microsoft/winget-cli/releases. Copie a URL da versão que você prefere e atualize o URI acima.

Para saber mais sobre a Área Restrita do Windows, incluindo como instalar uma área restrita e o que esperar do uso dela, confira os documentos da Área Restrita do Windows.

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. winget commandline

  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. 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
info Exibe metadados sobre o sistema (números de versão, arquitetura, local do log etc.). Útil para solução de problemas.
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.
pin Gerenciar pins de pacote.
configure Configura o sistema em um estado desejado.
fazer download Baixa o instalador do aplicativo especificado.

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)
  • ZIP
  • INNO
  • NULLSOFT
  • MSI
  • WIX
  • APPX
  • MSIX
  • BURN
  • PORTABLE

Winget de script

Você pode utilizar a seguinte sintaxe para instalar vários aplicativos em um único comando.

USAGE: winget install <query1> <query2> ...

Exemplo

winget install Microsoft.WindowsTerminal Microsoft.PowerToys Microsoft.VisualStudioCode

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: