Usar a ferramenta WinGet para instalar e gerenciar aplicativos

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 Package Manager.

Instalar o WinGet

WinGet o Windows Package Manager 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 pela Microsoft Store em versões do Windows Desktop e por meio de Atualizações no Windows Server 2025.

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 Package Manager 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 você o cliente WinGet, mas não habilitará as atualizações automáticas de novas versões prévias da Microsoft Store.

• Use uma conta da Microsoft (MSA), corporativa, de estudante ou de Azure Active Directory (AAD) para se inscrever no Windows Insider Program nos Canais Canário ou Desenvolvedor. Os canais Windows Insider Canary e Dev incluem atualizações automáticas de novas versões prévias do WinGet da Microsoft Store.

Instalar o WinGet no Windows Sandbox

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. Windows Sandbox não inclui o WinGet nem o aplicativo da Microsoft Store, portanto, você precisará baixar o pacote WinGet mais recente da página de lançamentos 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 um parâmetro com o cmdlet Repair-WinGetPackageManager. Para ver os parâmetros disponíveis para o cmdlet Repair-WinGetPackageManager, 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ê eleve 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.

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.

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.

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.

Opções

A ferramenta WinGet dá suporte às seguintes opções.

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

WinGet de script

O módulo Microsoft.WinGet.Client PowerShell está disponível no PowerShell Gallery.

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 da 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:

• problemas comuns: não reconhecidos, falha ao executar, versão do Instalador de Aplicativo ou variável PATH precisa de atualização
• erros comuns: erros 0x801901a0, 0x80d03002, 0x80070490