Use o WinGet para instalar e gerenciar aplicativos

WinGet é uma ferramenta de linha de comandos que permite aos utilizadores descobrir, instalar, atualizar, remover e configurar aplicações em computadores Windows 10, Windows 11 e Windows Server 2025. Esta ferramenta é a interface cliente para o serviço Windows Gestor de Pacotes.

Instalar o WinGet

WinGet o Windows Gestor de Pacotes está disponível em versões Windows 11, modernas do Windows 10 e Windows Server 2025 como parte do App Installer. O App Installer é um Componente do Sistema entregue e atualizado pela loja Microsoft nas versões Windows Desktop e através de Atualizações em Windows Server de 2025.

Instalar a versão de visualização do WinGet [Somente desenvolvedores]

WinGet está incluído no App Installer. Para experimentar as funcionalidades Windows Gestor de Pacotes mais recentes, pode instalar uma versão de pré-visualização de uma das seguintes formas:

• Transfira a versão de pré-visualização mais recente do WinGet. Leia as Notas de versão da visualização do WinGet para saber mais sobre os novos recursos. Instalar este pacote dará a versão de pré-visualização do cliente WinGet, mas não permitirá as atualizações automáticas das novas versões de pré-visualização da Microsoft Store.

• Use uma conta Microsoft (MSA), trabalho, escola ou conta Azure Active Directory (AAD) para se inscrever no Programa Windows Insider no Canary ou Dev Channels. Os canais Windows Insider, Canary e Dev incluem atualizações automáticas das novas versões pré-visualizadas do WinGet a partir da Microsoft Store.

Instalar o WinGet no Windows Sandbox

Windows Sandbox fornece um ambiente de ambiente de trabalho leve para executar aplicações isoladamente em segurança. O software instalado dentro do ambiente Sandbox do Windows mantém-se "sandboxado" e corre separadamente da máquina anfitriã. Windows Sandbox não inclui o WinGet, nem a aplicação Microsoft Store, por isso terá de descarregar o pacote mais recente do WinGet na página de lançamentos do WinGet na GitHub, ou usar o cmdlet Repair-WinGetPackageManager.

Para instalar a versão estável do WinGet no Windows Sandbox, siga estes passos do prompt de comandos do PowerShell do Windows:

$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 WinGet PowerShell no escopo da máquina, pode usar o parâmetro -Scope AllUsers com o cmdlet Install-Module. Se quiseres uma versão de pré-visualização do WinGet, podes adicionar -IncludePrerelease parâmetro com o Repair-WinGetPackageManager cmdlet. Para ver os parâmetros disponíveis para o Repair-WinGetPackageManager cmdlet, pode executar Get-Help Repair-WinGetPackageManager -Full.

Para mais informações sobre Windows Sandbox, incluindo como instalar um sandbox e o que esperar da sua utilização, consulte a documentação Windows Sandbox.

Considerações do administrador

O comportamento do instalador pode 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 instalação. Quando o instalador corre, Windows vai pedir para elevar. Se você optar por não elevar, o aplicativo não será instalado.

• Ao executar o WinGet em um prompt de comando do administrador, você não verá prompts de elevação se o aplicativo exigir. Tenha sempre cuidado ao executar a linha de comandos como administrador e instale apenas aplicações em que confia.

Usar WinGet

Depois que o App Installer for instalado, você pode executar o WinGet digitando 'winget' em um prompt de comando.

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

1. Para de pesquisa para uma ferramenta, digite winget search <appname>.

2. Depois de confirmar que a ferramenta desejada está disponível, você pode instalar ferramenta digitando winget install <appname>. A ferramenta WinGet irá iniciar o instalador e instalar o aplicativo no seu PC.

3. Além de instalar e pesquisar, 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 não estar em seu PATH.

Comandos

A versão atual da ferramenta WinGet suporta os seguintes comandos.

Opções

A ferramenta WinGet suporta as seguintes opções.

Formatos de instalação suportados

WinGet suporta os seguintes tipos de instaladores:

• EXE (com Silent e sinalizadores de SilentWithProgress)
• CEP
• INNO
• NULLSOFT
• MSI
• WIX
• appx
• MSIX
• QUEIMAR
• PORTÁTIL
• FONTE

Scriptar WinGet

O módulo PowerShell Microsoft.WinGet.Client está disponível na Galeria do PowerShell.

Depuração e solução de problemas

WinGet fornece registro em log para ajudar a diagnosticar problemas. Para detalhes sobre o registo e resolução de problemas, consulte Depuração e resolução de problemas.

Ferramentas em falta

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 do WinGet

Você pode configurar a experiência de linha de comando do WinGet modificando o arquivo settings.json . Para obter mais informações, consulte a página do comando settings.

Detalhes de código aberto

A ferramenta WinGet é open source software disponível em GitHub no repositório https://github.com/microsoft/winget-cli/. O código-fonte para criar o cliente encontra-se na pasta src.

A fonte para WinGet encontra-se numa solução Visual Studio C++ de 2022. Para construir a solução corretamente, clone o repositório e execute o arquivo de configuração WinGet apropriado localizado no diretório ".github".

Encorajamo-lo a contribuir para a fonte WinGet sobre GitHub. Deve primeiro concordar e assinar o Microsoft CLA. Os pedidos de pull devem ser feitos a partir de um branch no seu próprio fork.

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:

• problemas comuns -- não reconhecidos, falha na execução, versão do App Installer ou variável PATH precisam de atualização
• erros comuns -- Erro 0x801901a0, 0x80d03002, 0x80070490