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 comandos que permite aos utilizadores descobrir, installatualizar, remover e configurar aplicações em computadores com 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.
Observação
A ferramenta de linha de comandos WinGet só é suportada na versão Windows 10 1809 (build 17763) ou posterior. WinGet não estará disponível até iniciar sessão no Windows como um utilizador pela primeira vez, fazendo com que a Microsoft Store registe o Windows Gestor de Pacotes como parte de um processo assíncrono. Se iniciou sessão recentemente como utilizador pela primeira vez e descobrir que o WinGet ainda não está disponível, pode abrir o PowerShell e introduzir o seguinte comando para solicitar este registo WinGet: Add-AppxPackage -RegisterByFamilyName -MainPackage Microsoft.DesktopAppInstaller_8wekyb3d8bbwe.
Observação
É possível que o App Installer não esteja instalado no seu dispositivo. Nesse caso, pode ser descarregado aqui.
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 install fazer 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 install a versão estável do WinGet no Windows Sandbox, siga estes passos a partir 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 install o módulo PowerShell WinGet ao nível da máquina, pode utilizar 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 o Windows Sandbox, incluindo como install fazer um sandbox e o que esperar da sua utilização, 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, algumas aplicações podem exigir elevação para install. Quando o instalador corre, Windows vai pedir para elevar. Se optar por não elevar, a aplicação não conseguirá install.
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 cautela ao executar a sua linha de comandos como administrador e execute apenas install aplicações em que confie.
Usar WinGet
Depois de instalar o App Installer , pode executar o WinGet escrevendo 'winget' a partir de um Prompt de Comandos.
Um dos cenários de utilização mais comuns consiste em search para e install uma ferramenta preferida.
Para search uma ferramenta, introduza
winget search <appname>.Depois de confirmar que a ferramenta que deseja está disponível, pode install usá-la digitando
winget install <appname>. A ferramenta WinGet vai iniciar o instalador e install a aplicação no teu PC.
Além de install e search, o WinGet fornece vários outros comandos que permitem mostrar detalhes sobre aplicações, 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.
| Comando | Descrição |
|---|---|
| install | Instala o aplicativo especificado. |
| show | Exibe detalhes para o aplicativo especificado. |
| fonte | Adiciona, edita, remove e atualiza os repositórios Windows Gestor de Pacotes acedidos por WinGet. |
| search | Procura uma aplicação. |
| list | 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 ficheiro manifesto para submissão ao repositório Windows Gestor de Pacotes. |
| settings | Abra o settings. |
| recursos | Mostra o status das características experimentais. |
| export | Exporta uma lista dos pacotes instalados. |
| import | Instala todos os pacotes em um arquivo. |
| pin | 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 recursos da PowerShell Desired State Configuration (DSC) v3. |
Opções
A ferramenta WinGet suporta as 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, declaração de privacidade e políticas de grupo configuradas. |
| -?, --help | Mostra opções adicionais help do WinGet. |
| --wait | Solicita que o usuário pressione qualquer tecla antes de sair. |
| --logs,--open-logs | Abre a localização padrão dos registos. |
| --verbose,--verbose-logs | Permite o registo verboso para winget. |
| --nowarn,--ignore-warnings | Suprime mensagens de aviso. |
| --disable-interactivity | Desativa prompts interativos. |
| --proxy | Define um proxy a ser usado para essa execução. |
| --no-proxy | 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
- FONTE
Scriptar WinGet
O módulo PowerShell Microsoft.WinGet.Client está disponível na Galeria do PowerShell.
Depuração e solução de problemas
O WinGet fornece registo para help 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 o WinGet settings
Pode configurar a experiência de linha de comandos do WinGet modificando o ficheiro settings.json. Para mais informações, consulte a página do settings comando.
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 wingetrepositório -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