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.
O WinGet é uma ferramenta de linha de comando que permite que os usuários descubram, installatualizem, 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.
Observação
É possível que o Instalador de Aplicativos não esteja instalado em seu dispositivo. Nesse caso, ele pode ser baixado aqui.
Instalar a versão prévia do WinGet [Somente para desenvolvedores]
O WinGet está incluído no Instalador de Aplicativos. Para experimentar os recursos mais recentes do Windows Gerenciador de Pacotes, você pode install instalar uma versão prévia de uma das seguintes formas:
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), conta corporativa, escolar ou do Microsoft Entra ID (anteriormente Azure Active Directory) para se inscrever no Programa Windows Insider nos Canais Canary ou 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 install a versão estável do WinGet no Windows Sandbox, siga estas etapas no prompt de comando do 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 install o módulo do PowerShell do WinGet no escopo da máquina, você pode usar o parâmetro -Scope AllUsers com o cmdlet Install-Module. 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 o Windows Sandbox, incluindo como install um sandbox e o que esperar ao usá-lo, consulte a documentação do 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 install. Quando o instalador for executado, o Windows solicitará que você elevar privilégios. Se você optar por não elevar, o aplicativo falhará install.
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 tenha cuidado ao executar o prompt de comando como administrador e execute somente install aplicativos em que você confia.
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 é para search e install uma ferramenta favorita.
Para search uma ferramenta, digite
winget search <appname>.Depois de confirmar que a ferramenta desejada está disponível, você pode usar install a ferramenta digitando
winget install <appname>. A ferramenta WinGet iniciará o instalador e install o aplicativo no computador.
Além install de e search, o WinGet fornece uma série de outros comandos que permitem mostrar detalhes sobre aplicativos, alterar fontes e validar 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. |
source |
Adiciona, edita, remove e atualiza os repositórios Windows Gerenciador de Pacotes acessados pelo WinGet. |
search |
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. |
settings |
Abra o settings. |
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. |
-?, --help |
Exibe informações adicionais help para o WinGet. |
--wait |
Solicita que o usuário pressione qualquer tecla antes de sair. |
--logs, --open-logs |
Abre o local de logs padrão. |
--verbose, --verbose-logs |
Habilita o log detalhado para 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 logs para help 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 o WinGet settings
Você pode configurar a experiência de linha de comando do WinGet modificando o settings arquivo.json . Para obter mais informações, consulte a página do settings comando.
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 wingetrepositório -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