Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
WinGet é uma ferramenta de linha de comando que permite que os usuários descubram, instalem, atualizem, removam e configurem aplicativos em computadores Windows 10, Windows 11 e Windows Server 2025. Essa ferramenta é a interface do cliente para o serviço Windows Gerenciador de Pacotes.
Instalar o WinGet
WinGet o Windows Gerenciador de Pacotes está disponível em Windows 11, versões modernas do Windows 10 e Windows Server 2025 como parte do App Installer. O App Installer é um Componente do Sistema entregue e atualizado pelo repositório Microsoft em versões do Windows Desktop e por meio de Atualizações no Windows Server 2025.
Observação
A ferramenta de linha de comando WinGet só tem suporte no Windows 10 versão 1809 (build 17763) ou posterior. O WinGet não estará disponível até que você tenha entrado em Windows como usuário pela primeira vez, disparando Microsoft Store para registrar o Windows Gerenciador de Pacotes como parte de um processo assíncrono. Se você fez logon recentemente como usuário pela primeira vez e descobrir que o WinGet ainda não está disponível, abra o PowerShell e insira o seguinte comando para solicitar esse registro do WinGet: 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 Aplicativos. Para experimentar os recursos de Windows Gerenciador de Pacotes mais recentes, você pode instalar uma versão prévia 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 versão prévia do cliente WinGet, mas não habilitará atualizações automáticas de novas versões prévias do Microsoft Store.
Use uma conta Microsoft (MSA), de trabalho, escolar ou de Azure Active Directory (AAD) para se inscrever no Programa Windows Insider no Canal Canary ou Canal Dev. Os canais Windows Insider Canary e Dev incluem atualizações automáticas de novas versões prévias do WinGet do Microsoft Store.
Instalar o WinGet no Sandbox do Windows
Windows Sandbox fornece um ambiente de área de trabalho leve para executar aplicativos com segurança em isolamento. O software instalado dentro do ambiente de área restrita Windows permanece "em área restrita" e é executado separadamente do computador host. Sandbox do Windows não inclui o WinGet nem o aplicativo Microsoft Store, portanto, você precisará baixar o pacote WinGet mais recente da página de versões do WinGet no GitHub ou usar o "cmdlet" Repair-WinGetPackageManager.
Para instalar a versão estável do WinGet no Windows Sandbox, siga estas etapas em um prompt de comando Windows PowerShell:
$progressPreference = 'silentlyContinue'
Write-Host "Installing WinGet PowerShell module from PSGallery..."
Install-PackageProvider -Name NuGet -Force | Out-Null
Install-Module -Name Microsoft.WinGet.Client -Force -Repository PSGallery | Out-Null
Write-Host "Using Repair-WinGetPackageManager cmdlet to bootstrap WinGet..."
Repair-WinGetPackageManager -AllUsers
Write-Host "Done."
Para instalar o módulo do WinGet PowerShell no escopo do computador, você pode usar o -Scope AllUsers parâmetro com o Install-Module cmdlet. Se você quiser uma versão prévia do WinGet, poderá adicionar -IncludePrerelease parâmetro com o Repair-WinGetPackageManager cmdlet. Para ver os parâmetros disponíveis para o Repair-WinGetPackageManager cmdlet, você pode executar Get-Help Repair-WinGetPackageManager -Full.
Para obter mais informações sobre Windows Área Restrita, incluindo como instalar uma área restrita e o que esperar de seu uso, consulte os documentos Windows Sandbox.
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ê elevar privilégios. 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 Aplicativos for instalado, você poderá 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 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. |
| origem | Adiciona, edita, remove e atualiza os repositórios Windows Gerenciador de Pacotes acessados pelo WinGet. |
| buscar | Pesquisa um aplicativo. |
| list | Exibir os pacotes instalados. |
| upgrade | Atualiza o aplicativo especificado. |
| uninstall | Desinstala o aplicativo especificado. |
| hash | Gera o hash SHA256 para o instalador. |
| validate | Valida um arquivo de manifesto para envio ao repositório de Windows Gerenciador de Pacotes. |
| Configurações | Abrir as configurações. |
| features | 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. |
| download | Baixa o instalador do aplicativo especificado. |
| repair | Repara o aplicativo selecionado. |
| dscv3 | Comandos de recurso do PowerShell Desired State Configuration (DSC) v3. |
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. |
| -?--Ajuda | Mostra ajuda adicional para o WinGet. |
| --esperar | Solicita que o usuário pressione qualquer tecla antes de sair. |
| --logs,--open-logs | Abre o local de logs padrão. |
| --verbose, --verbose-logs | Habilite o registro em log detalhado WinGet. |
| --nowarn,--ignore-warnings | Suprime as saídas de aviso. |
| --disable-interactivity | Desabilita solicitações interativas. |
| --proxy | Define um proxy a ser usado para essa execução. |
| --no-proxy | Desabilita o uso de proxy para essa execução. |
Formatos de instalador com suporte
O WinGet dá suporte aos seguintes tipos de instaladores:
- EXE (com sinalizadores Silent e SilentWithProgress)
- ZIP
- INNO
- NULLSOFT
- MSI
- WIX
- appx
- MSIX
- BURN
- PORTÁTIL
- FONTE
WinGet de script
O módulo Microsoft.WinGet.Client PowerShell está disponível no Galeria do PowerShell.
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 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 a página do comando de configurações.
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 origem do WinGet está contida em uma solução Visual Studio 2022 C++. Para criar a solução corretamente, clone o repositório e execute o arquivo de Configuração do WinGet apropriado localizado no diretório ".github".
Recomendamos que você contribua para a origem WinGet no GitHub. Primeiro, você deve concordar e assinar o CLA Microsoft. As solicitações de pull devem vir de uma ramificação em sua própria bifurcação.
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 resolver:
Colaborar conosco no GitHub
A fonte deste conteúdo pode ser encontrada no GitHub, onde você também pode criar e revisar problemas e solicitações de pull. Para obter mais informações, confira o nosso guia para colaboradores.
Windows developer