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 uma conta 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 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