Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
WinGet é uma ferramenta de linha de comando que permite aos usuários descobrir, instalar, atualizar, remover e configurar aplicativos em computadores Windows 10, Windows 11 e Windows Server 2025. Esta ferramenta é a interface do cliente para o serviço Gerenciador de Pacotes do Windows.
Instalar o WinGet
WinGet o Gerenciador de Pacotes do Windows está disponível no Windows 11, versões modernas do Windows 10 e Windows Server 2025 como parte do App Installer. O App Installer é um Componente do Sistema fornecido e atualizado pela Microsoft Store nas versões da Área de Trabalho do Windows e por meio de Atualizações no Windows Server 2025.
Observação
A ferramenta de linha de comando WinGet só é suportada no Windows 10 versão 1809 (compilação 17763) ou posterior. O WinGet não estará disponível até que você tenha feito login no Windows como usuário pela primeira vez, acionando a Microsoft Store para registrar o Gerenciador de Pacotes do Windows como parte de um processo assíncrono. Se você fez login recentemente como usuário pela primeira vez e descobriu que o WinGet ainda não está disponível, você pode abrir o PowerShell e inserir o seguinte comando para solicitar esse registro do WinGet: Add-AppxPackage -RegisterByFamilyName -MainPackage Microsoft.DesktopAppInstaller_8wekyb3d8bbwe.
Instalar a versão de visualização do WinGet [Somente desenvolvedores]
WinGet está incluído no App Installer. Para experimentar os recursos mais recentes do Gerenciador de Pacotes do Windows, você pode instalar uma compilação de visualização de uma das seguintes maneiras:
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. A instalação deste pacote lhe dará a versão de visualização do cliente WinGet, mas não habilitará as atualizações automáticas de novas versões de visualização da Microsoft Store.
Use uma conta da Microsoft (MSA), trabalho, escola ou conta do Azure Ative Directory (AAD) 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 de pré-visualização do WinGet da Microsoft Store.
Use uma Conta da Microsoft (MSA) para se inscrever no Programa Insiders do Gerenciador de Pacotes do Windows. Assim que a sua Conta Microsoft (MSA) for adicionada (alguns dias após receber uma notificação por correio eletrónico), receberá atualizações automáticas de novas versões de pré-visualização da Microsoft Store.
Instalar o WinGet na Sandbox do Windows
O Windows Sandbox fornece um ambiente de área de trabalho leve para executar aplicativos com segurança isoladamente. O software instalado dentro do ambiente de Sandbox do Windows permanece em área restrita e é executado separadamente da máquina host. O 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 versões do WinGet no GitHub ou usar o cmdlet Repair-WinGetPackageManager.
Para instalar a versão estável do WinGet na Sandbox do Windows, siga estas etapas em um 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 o módulo WinGet PowerShell no escopo da máquina, pode usar o parâmetro -Scope AllUsers com o cmdlet Install-Module. Se desejar uma versão de visualização do WinGet, você pode adicionar -IncludePrerelease 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 -Fullo .
Para obter mais informações sobre o Windows Sandbox, incluindo como instalar uma sandbox e o que esperar do seu uso, consulte a documentação do 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 for executado, o Windows solicitará que você eleve . 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.
Para de pesquisa para uma ferramenta, digite
winget search <appname>.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.
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 visualização atual da ferramenta WinGet suporta os seguintes comandos.
| Comando | Descrição |
|---|---|
| instalar | Instala o aplicativo especificado. |
| mostrar | Exibe detalhes para o aplicativo especificado. |
| fonte | Adiciona, remove e atualiza os repositórios do Gerenciador de Pacotes do Windows acessados pelo WinGet. |
| Pesquisar | Procura uma aplicação. |
| Lista | Exiba os pacotes instalados. |
| atualização | Atualiza o aplicativo especificado fornecido. |
| desinstalar | Desinstala o aplicativo especificado. |
| hash | Gera o hash SHA256 para o instalador. |
| validar | Valida um arquivo de manifesto para envio ao repositório do Gerenciador de Pacotes do Windows. |
| Configurações | Abra as configurações. |
| recursos | Mostra o status das características experimentais. |
| exportação | Exporta uma lista dos pacotes instalados. |
| importar | Instala todos os pacotes em um arquivo. |
| alfinete | Gerencie os pinos do pacote. |
| configurar | Configura o sistema em um estado desejado. |
| baixar | Faz o download do instalador do aplicativo especificado. |
| repair | Repara o aplicativo selecionado. |
| DSCV3 | Comandos de recurso da Configuração de Estado Desejado (DSC) v3 do PowerShell. |
Opções
A ferramenta WinGet suporta as seguintes opções.
| Opção | Descrição |
|---|---|
| -v, --versão | Retorna a versão atual do WinGet. |
| --informação | Fornece todas as informações detalhadas sobre o WinGet, incluindo os links para a licença, declaração de privacidade e políticas de grupo configuradas. |
| -?, --ajuda | Mostra ajuda adicional para WinGet. |
| --aguarde | Solicita que o usuário pressione qualquer tecla antes de sair. |
| pt-PT: --logs,--open-logs | Abre a localização padrão dos registos. |
| --Verbose,--Verbose-Logs | Permite o registo detalhado do winget. |
| --nowarn,--ignore-avisos | Suprime mensagens de aviso. |
| --desabilitar-interatividade | Desativa prompts interativos. |
| --proxy | Define um proxy a ser usado para essa execução. |
| --sem procuração | Desabilita o uso de proxy para essa execução. |
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
Scriptar WinGet
O módulo Microsoft.WinGet.Client PowerShell 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 é um software de código aberto disponível no GitHub no repositório https://github.com/microsoft/winget-cli/. O código-fonte para criar o cliente encontra-se na pasta src.
A origem do WinGet está contida em uma solução C++ do Visual Studio 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".
Nós encorajamos você a contribuir para a fonte WinGet no GitHub. Você 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:
Colabore connosco no GitHub
A origem deste conteúdo pode ser encontrada no GitHub, onde também pode criar e rever problemas e pedidos Pull. Para mais informações, consulte o nosso guia do contribuidor.
Windows developer