Winget no Windows: Guia completo de comandos e uso avançado.

Última atualização: 20 de fevereiro de 2026
  • Winget é o gerenciador de pacotes oficial do Windows que permite instalar, atualizar e desinstalar aplicativos a partir da linha de comando.
  • A ferramenta integra-se com a Microsoft Store, um repositório da comunidade e fontes privadas, e suporta uma ampla variedade de formatos de instalador.
  • Ele permite automatizar equipes inteiras usando arquivos de configuração YAML, scripts do PowerShell e políticas de grupo em ambientes corporativos.
  • Inclui funcionalidades avançadas como download sem instalação, validação de manifesto, PIN de versão e amplas opções de segurança e registro.

Comandos winget no Windows

Se você usa o Windows diariamente e passa metade da sua vida instalando, atualizando ou removendo programas, aprender a usar o Winget pelo terminal pode economizar muito tempo. Este gerenciador de pacotes oficial da Microsoft traz para o Windows uma forma de trabalho muito semelhante à das distribuições GNU/Linux com apt ou dnf, mas sem a necessidade de instalar ferramentas de terceiros.

Com o Winget, você pode pesquisar, instalar, atualizar, desinstalar e configurar aplicativos simplesmente digitando comandos, além de automatizar toda a configuração de um PC usando scripts ou arquivos de configuração. Vamos analisar mais detalhadamente como ele funciona, quais comandos estão disponíveis e como tirar o máximo proveito dele, seja você um usuário doméstico, desenvolvedor ou administrador de sistemas.

O que é o Winget e como funciona o Gerenciador de Pacotes do Windows?

O Winget é a ferramenta de linha de comando para o Gerenciador de Pacotes do Windows . É um cliente que se conecta a várias fontes (a Microsoft Store, o repositório da comunidade Winget e repositórios privados) para localizar instaladores, baixá-los e realizar uma instalação controlada e repetível.

Na prática, o winget é composto por vários elementos que trabalham em conjunto para gerenciar o software no sistema, de modo que o núcleo visível ao usuário é o comando winget , mas nos bastidores existem serviços e manifestos que descrevem cada pacote.

A solução completa do Gerenciador de Pacotes do Windows inclui três componentes principais que é importante distinguir para compreender todo o ecossistema:

  • Cliente Winget: é o executável do console que você usa no PowerShell, Terminal ou prompt de comando para executar comandos como winget install o winget upgrade.
  • Serviço de embalagem e armazenamentoA Microsoft mantém um repositório comunitário de manifestos no GitHub e se integra à Microsoft Store para hospedar e distribuir aplicativos em computadores Windows.
  • Arquivos de configuração do WingetSão arquivos YAML que descrevem o "estado desejado" de um PC (aplicativos, configurações, scripts), permitindo Configurar um dispositivo inteiro com um único comando..

A filosofia é que você pode definir o software e a configuração que deseja, e o Gerenciador de Pacotes cuidará da instalação, atualização e manutenção de tudo automaticamente, minimizando erros humanos e diferenças entre máquinas.

Instalando o Winget no Windows 10, Windows 11 e Windows Server

Na maioria dos dispositivos modernos, o Winget já vem pronto para uso, pois faz parte do pacote. Instalador de aplicativos Ele é distribuído pela Microsoft Store no Windows 10 e Windows 11, e por meio de atualizações no Windows Server 2025. Basta abrir um terminal e digitar winget Para verificar se está disponível.

Se você visualizar a lista de opções e a versão do cliente ao executar o comando, significa que o Gerenciador de Pacotes do Windows está instalado corretamente . Caso contrário, você pode acessar a Microsoft Store, pesquisar por "Instalador de Aplicativos" e atualizar ou instalar o pacote.

Instale as versões de pré-visualização do winget (para desenvolvedores)

Se você quiser experimentar os novos recursos do Winget antes de qualquer outra pessoa, a Microsoft oferece versões de pré-visualização . Elas são destinadas principalmente a desenvolvedores e usuários avançados que não se importam de encontrar alguns bugs ocasionais.

Existem duas maneiras comuns de obter a pré-visualização do cliente:

  • Faça o download manual do pacote da versão de pré-visualização do repositório winget no GitHub e Instale-o para substituir temporariamente o cliente estável.Você não receberá atualizações automáticas para as próximas versões de pré-visualização na Loja; você terá que repetir o processo quando uma nova versão for lançada.
  • Junte-se a Windows Insider Com uma conta Microsoft, conta corporativa, conta escolar ou ID Entra (anteriormente AAD) nos canais Canary ou Dev. Nesses canais, as compilações incluem automaticamente Atualizações do Winget da Microsoft Store com as funções experimentais mais recentes.

Instalando o Winget no ambiente isolado do Windows (Sandbox)

O Windows Sandbox é um ambiente de desktop leve e descartável onde você pode executar aplicativos isoladamente do sistema principal . Tudo o que você instalar dentro dele será perdido ao fechar o sandbox, tornando-o ideal para testes.

Este ambiente não vem com a Microsoft Store ou o Winget pré-instalados, então você terá que... Instale o cliente manualmente.A Microsoft recomenda o uso do módulo do PowerShell. Microsoft.WinGet.Client e o cmdlet Repair-WinGetPackageManager para "iniciar" winget dentro da caixa de areia.

A partir de um console do PowerShell no ambiente de teste (sandbox), você pode usar um script como este (adaptado e formatado) para implantar a versão estável para todos os usuários no ambiente:

$progressPreference = 'silentlyContinue'
Install-PackageProvider -Name NuGet -Force | Out-Null
Install-Module -Name Microsoft.WinGet.Client -Force -Repository PSGallery | Out-Null
Repair-WinGetPackageManager -AllUsers

Caso necessário, o módulo também pode ser instalado com escopo do usuário ou da máquina usando o parâmetro -Scope AllUsers en Install-Modulee você pode adicionar -IncludePrerelease a Repair-WinGetPackageManager para testar versões de pré-visualização.

Considerações importantes sobre autorizações e procedimentos administrativos

O comportamento das instalações com o Winget varia dependendo se você executa os comandos com privilégios de administrador ou como um usuário normal . Isso é fundamental se você gerencia muitos computadores ou deseja automatizar processos.

Ao iniciar o Winget sem privilégios elevados, alguns aplicativos exigirão elevação de privilégios para serem instalados. Nesses casos, o Windows exibirá uma solicitação de Controle de Conta de Usuário (UAC) pedindo confirmação. Se você recusar a elevação de privilégios, a instalação ou atualização desse pacote específico falhará.

Se você abrir o PowerShell ou o Prompt de Comando como administrador e executar `winget`, as instalações que exigem privilégios elevados não exibirão a solicitação de Controle de Conta de Usuário (UAC) , já que o contexto já possui privilégios elevados. Isso é conveniente, mas significa que você deve ter muito cuidado e instalar apenas softwares confiáveis , especialmente em ambientes corporativos.

  Plugin do Home Assistant: guia completo para os principais complementos e integrações.

Em cenários mistos (programas que devem ser executados em nível de usuário versus nível de máquina), é comum combinar as execuções do winget como usuário e como administrador , ou usar políticas de grupo para forçar determinados comportamentos e reduzir os avisos.

Uso básico do winget: primeiros comandos essenciais

Depois de atualizar o App Installer, usar o winget é muito simples. Abra o PowerShell, o Terminal do Windows ou o CMD. e escrever wingetVocê verá a versão instalada, uma visão geral e uma lista de comandos disponíveis.

O fluxo de trabalho típico quase sempre começa com uma pesquisa, seguida da instalação do aplicativo desejado. Os passos essenciais seriam algo como:

  1. Procure um aplicativo: winget search <nombre_de_app>
  2. Verifique o nome, o identificador e a origem do pacote desejado.
  3. Instale-o: winget install <nombre_o_id>

Durante a instalação, o winget baixa o instalador correto para sua arquitetura e código-fonte e o executa com os parâmetros apropriados (geralmente em modo silencioso ou minimizando a interação), informando ao final se tudo correu bem.

Se você quiser ver os aplicativos que já tem instalados no seu sistema, pode iniciar o processo. winget list de modo que um Lista de pacotes instalados com suas respectivas versões.Este comando é muito útil para verificar o que pode ser atualizado e o que é reconhecido pelo Winget, mesmo que não tenha sido instalado originalmente com esta ferramenta.

Lista completa dos principais comandos do winget

O cliente suporta uma série de comandos específicos projetados para abranger todo o ciclo de vida e configuração do aplicativo. Atualmente, os comandos gerais mais importantes são:

Comando Descrição
install Instalar O aplicativo indicado pela fonte configurada.
show Amostra Informação detalhada de um pacote (editor, versão, origens, etc.).
source Permite Adicionar, remover ou atualizar repositórios de pacotes.
search torna um pesquisar de aplicações nas fontes configuradas.
list Mostra o lista de pacotes instalados reconhecido por winget.
upgrade Atualização aplicações específicas ou todas aquelas que possuem uma nova versão.
uninstall Desinstalar uma aplicação específica.
hash Calcule o Hash SHA256 de um instalador.
validate Verifica a validade de um manifesto antes de enviá-lo para o repositório da comunidade.
settings Abra e permita a edição do arquivo. configuração do winget.
features Mostra o estado do funções experimentais.
export Exportações Em um arquivo, salve a lista de pacotes instalados.
import Instalar em massa todos os pacotes listados em um arquivo exportado.
pin Permite versões de âncora de pacotes para que não sejam atualizados além de um determinado ponto.
configure Executar arquivos de configuração declarativa Deixar o sistema no estado desejado.
download Baixar instaladores de aplicativos sem executá-los.
repair Tentar reparar instalações problemáticas.
dscv3 Comandos relacionados a PowerShell DSC v3 e recursos de configuração de estado desejados.

Opções globais e parâmetros mais utilizados

Quase todos os comandos do Winget aceitam opções globais que modificam seu comportamento, como exibir mais informações, controlar o proxy ou suprimir avisos. Algumas das mais relevantes são:

opção Função
-v, --version Mostra o versão atual do cliente winget.
--info Retorna informações detalhadas sobre a instalação (licenças, privacidade, políticas de grupo, etc.).
-?, --help Apresenta o ajuda específica de um comando.
--wait Faz winget Aguarde uma chave antes de sair, útil ao executar em janelas efêmeras.
--logs, --open-logs Abra a pasta padrão onde o registros winget.
--verbose, --verbose-logs Ative um registro detalhado para depuração.
--nowarn, --ignore-warnings Esconda o mensagens de aviso.
--disable-interactivity Tente desativar todas as solicitações interativas Para uso automatizado.
--proxy Estabelece o Proxy HTTP/HTTPS a ser utilizado durante essa execução.
--no-proxy Forçar uma asa Não utilize um proxy. mesmo que o sistema o tenha configurado.

Principais funções práticas: pesquisar, instalar, listar e atualizar.

No uso diário, você usará o Winget principalmente para alguns comandos bem diretos que permitem gerenciar aplicativos sem precisar mexer manualmente nos instaladores , assim como você faria com um gerenciador de pacotes no Linux.

Para localizar o software disponível, você tem à sua disposição os seguintes recursos. winget search <texto>que retorna uma lista de nomes, identificadores, versões e origens que correspondem à pesquisa. Esta lista também ajuda a identificar o ID exato do pacote que você deseja instalar.

Para verificar quais programas você tem instalados, basta executar winget listO comando exibe todos os aplicativos que o Winget reconhece, independentemente de terem sido instalados com a ferramenta ou não, e permite que você detectar versões antigas que precisam ser atualizadas.

A instalação padrão é feita com winget install NOMBRE_APP ou melhor ainda com o ID do pacote, por exemplo: winget install Microsoft.VisualStudioCodeSe a instalação exigir interação (aceitar o EULA, escolher opções, etc.), ela geralmente é feita em modo simplificado ou silencioso, na medida do possível.

Às vezes, o instalador pausa o processo para pedir que você aceite um contrato de licença ou confirme algo na tela. Para garantir que tudo ocorra sem problemas do início ao fim, sem avisos, você pode usar parâmetros como --silent y --accept-package-agreements --accept-source-agreements, de forma que Você forçará a aceitação dos acordos e removerá janelas desnecessárias..

Para manter o sistema atualizado, o winget oferece diversas maneiras de atualizar o software. O comando winget upgrade Sem mais delongas, mostrará Todos os aplicativos com novas versões disponíveisEnquanto winget upgrade NOMBRE_APP Atualizará apenas um pacote específico.

Se preferir fazer tudo de uma vez, winget upgrade --all Ele tentará atualizar todos os pacotes que possuem uma versão mais recente. É aqui que as permissões entram em jogo: se você executá-lo como um usuário, Avisos UAC serão emitidos para cada instalação que necessite de içamento.Se você fizer isso como administrador, eles serão gerenciados sem exibir as caixas de diálogo.

  Erro 0x803f8001 no Windows: causas, soluções e dicas

Por fim, desinstalar também é muito fácil com winget uninstall NOMBRE_APPE você pode até mesmo Incluir vários aplicativos na mesma linha de comando para que sejam removidos um após o outro, desde que o winget os reconheça no sistema.

Comandos menos conhecidos, mas muito úteis.

Além dos comandos básicos, o winget inclui diversas funções que passam despercebidas em muitos guias rápidos e que são muito práticas ao trabalhar com vários pacotes ou quando é necessário evitar erros de identificação.

Comando winget show NOMBRE_APP É usado para ver todos os detalhes de um pacote antes de instalá-lo: editora, versão específica, ID, fonte, tipo de instalador e, às vezes, até mesmo o link oficial. Você também pode filtrar por identificador com winget show --id ID_PAQUETE Apostar no que é certo.

Se você está preocupado com a possibilidade da instalação ficar travada enquanto aguarda a aceitação dos contratos de licença, você pode adicionar os parâmetros. --accept-package-agreements y --accept-source-agreements a winget install para Os termos legais são automaticamente aceitos. Sem caixa de diálogo.

Combinando essas opções com --silent, por exemplo winget install NOMBRE_APP --accept-package-agreements --accept-source-agreements --silent, você consegue instalações completamente desacompanhadasMuito útil em scripts de implantação ou quando você quer deixar o PC funcionando enquanto faz outra coisa.

Comando winget download: baixar instaladores sem instalar

Em determinadas situações, você pode querer baixar instaladores de aplicativos, mas não executá-los ainda : por exemplo, para movê-los para máquinas offline, preparar um repositório local ou revisar manualmente o conteúdo antes da instalação.

É para isso que serve o comando. winget download, cujo uso básico é winget download [[-q] <query>] [<options>]Ele suporta consultas genéricas e filtros por ID, nome ou apelido, e baixa o instalador (ou instaladores) correspondente à sua seleção.

Quando o pacote provém da Microsoft Store e é uma aplicação empacotada ( MSIX, APPX, bundles, etc. ), o `winget` também pode descarregar o ficheiro de licença associado. Nestes casos, o comando requer autenticação com um ID Entra e que a conta pertença a funções como Administrador Global, Administrador de Utilizadores ou Administrador de Licenças para gerar e recuperar esse ficheiro de licença offline.

Se você quiser evitar lidar com a licença offline, pode usar o parâmetro. --skip-license o --skip-microsoft-store-package-licensepara que winget Basta baixar o instalador e não tente obter o arquivo de licença..

O comando também permite filtrar por plataforma ou arquitetura. --platform Você pode escolher entre valores como Windows.Desktop, Windows.Universal o Windows.Holographic prevenir limitar downloads a um tipo específico de dispositivo.

Da mesma forma, com --architecture você pode indicar x86, x64, ARM ou ARM64 Para selecionar apenas o instalador apropriado para a CPU de destino. Isso é especialmente útil se você for mover esses arquivos para outros computadores com uma arquitetura diferente da sua.

Entre as opções mais frequentes de winget download incluem:

  • -d, --download-directoryPasta onde os instaladores baixados serão salvos.
  • -m, --manifest: caminho para um manifesto YAML que descreve o que deve ser baixado.
  • --id, --name, --moniker: filtros para restringir o resultado a um pacote específico.
  • -v, --version: versão exata para baixar, caso não queira a versão mais recente.
  • -s, --source: limita a operação a uma origem específica.
  • --scope, --installer-type, --locale, --skip-dependenciesOpções avançadas para controlar detalhadamente o que é baixado.

Alguns exemplos práticos seriam:

winget download --id Microsoft.PowerToys --version 0.15.2
winget download --id Microsoft.WingetCreate --installer-type msix
winget download --id Microsoft.PowerToys --scope machine --architecture x64 --download-directory C:\Instaladores

Formatos de instalação compatíveis com Winget

Para funcionar de forma consistente com milhares de aplicativos, o winget reconhece vários tipos comuns de instaladores do Windows , incluindo instaladores modernos e instaladores clássicos.

Os formatos atualmente suportados incluem:

  • Executáveis EXE com parâmetros de instalação silenciosa (Silent o SilenciosoComProgresso).
  • registros ZIP que são implantadas em modo portátil.
  • instaladores Inno setup.
  • instaladores Nullsoft (NSIS).
  • Pacotes MSI y WIX.
  • Aplicativos empacotados APPX y MSIX.
  • Tipo de instaladores BURN.
  • Aplicativos laptops (sem instalação tradicional, executáveis ​​diretos).

Graças a essa variedade, o winget pode gerenciar tanto aplicativos modernos da Loja quanto programas tradicionais de desktop , desde que seus manifestos estejam definidos corretamente no repositório correspondente.

Criação de scripts e automação com WinGet e PowerShell

Se você gosta de automatizar tarefas ou gerenciar várias equipes, combinar o Winget com PowerShell e scripts declarativosPara isso, a Microsoft está publicando o módulo. Microsoft.WinGet.Client na Galeria do PowerShell, que expõe cmdlets específicos para interagir com o serviço.

Com este módulo, você pode criar scripts que instalam, atualizam ou reparam pacotes usando apenas PowerShell, integrar o winget em pipelines de CI/CD ou incorporá-lo em scripts para provisionamento de novas máquinas.

Além disso, os arquivos de configuração YAML associados ao comando winget configure permitem descrever em um único documento:

  • Pré-requisitos (afirmações), como versão mínima do Windows.
  • Recursos, que incluem pacotes para instalar, scripts para executar, configurações do sistema, etc.

Uma configuração de exemplo simplificada pode incluir uma seção de asserções onde a versão mínima do Windows 10 é definida e uma seção de recursos com o Visual Studio Code, o Google Chrome e um script do PowerShell para preparar outros módulos. Depois de ter esse arquivo YAML, basta executar:

winget configure --file ruta\a\winget.yaml

Dessa forma, um único comando deixa o computador com o mesmo conjunto de aplicativos e configurações repetidamente, ideal para ambientes corporativos, salas de aula, laboratórios ou para o seu próprio PC após a formatação.

Adicione repositórios e trabalhe com fontes personalizadas.

Por padrão, o Winget utiliza a Microsoft Store e o repositório da comunidade mantido no GitHub como fontes principais. No entanto, você também pode adicionar repositórios adicionais para expandir o catálogo ou trabalhar com os pacotes internos da sua organização.

Muitos ambientes corporativos criam sua própria fonte REST com manifestos para seus aplicativos corporativos, para que os usuários possam instalá-los usando o winget como se fossem pacotes públicos , mas controlando versões, licenças e distribuição.

Para adicionar uma nova fonte, abra o PowerShell como administrador e execute um comando como este:

winget source add --name MiRepositorio --arg https://url.de.mi.repo/api

O comando suporta opções adicionais, tais como: --type (tipo de origem, geralmente REST), --trust-level (por exemplo confiável o Nenhum) E --accept-source-agreements, Isso funciona para aceitar automaticamente os termos desse repositório sem precisar confirmar manualmente.

  Como personalizar a barra de ferramentas do Google Chrome

Para verificar se a fonte foi adicionada corretamente, você pode usar winget source list e consulte a lista de fontes registradas. Você também pode atualizar ou excluir fontes quando não precisar mais delas.

Winget para desenvolvedores, ISVs e empresas

Embora qualquer usuário possa se beneficiar do winget, ele realmente brilha nas mãos de desenvolvedores, fabricantes de software e administradores de TI que precisam padronizar instalações e ambientes de trabalho.

Os desenvolvedores podem descrever suas ferramentas essenciais (editores, SDKs, compiladores, vários utilitários) em um arquivo e deixar que o Gerenciador de Pacotes do Windows se encarregue de instalar todas as dependências corretamente , sem omissões ou versões inconsistentes entre máquinas.

Os fornecedores de software (ISVs) têm acesso ao repositório da comunidade Winget no GitHub, onde podem carregar os manifestos de seus aplicativos para que a ferramenta os inclua na fonte padrão. Os pacotes são validados automaticamente e também podem passar por revisão manual para garantir sua qualidade.

Em ambientes corporativos, o Winget simplifica a tarefa das equipes de segurança e TI, pois pode ser usado em conjunto com o Microsoft Intune e as políticas de grupo para impor políticas rigorosas sobre o que é instalado, de quais fontes e sob quais condições, reduzindo riscos e mantendo um nível consistente de atualizações e reforço de segurança.

Segurança, ancoragem de certificados e políticas de grupo

A conexão entre Winget, Microsoft Store e outras fontes REST é protegida por verificações de certificado e mecanismos de segurança para evitar ataques do tipo "homem no meio" (MITM) e roubo de credenciais ou dados.

No caso específico da Microsoft Store, existe uma política chamada BypassCertificatePinningForMicrosoftStore que Verifique se o Winget valida o hash do certificado da loja. em relação a uma lista de certificados conhecidos. Isso é fundamental quando a organização usa firewalls com inspeção SSL que podem interferir na validação.

As opções nesta política são:

  • Sem configuração (padrão)O winget respeita as configurações padrão do Gerenciador de Pacotes e verifica os certificados da Loja.
  • AtivarA validação do certificado da Microsoft Store foi omitida, o que pode ser necessário em alguns cenários de inspeção SSL, mas O risco de ataques MITM aumenta..
  • DesabilitarO Winget é obrigado a validar se o certificado realmente pertence à loja antes de iniciar a conexão.

O certificado fixado (certificate pinning) é uma camada extra de segurança que garante que a comunicação entre o cliente Winget e a Microsoft Store não possa ser facilmente interceptada ou manipulada . Desativá-lo sem um bom motivo é uma má ideia do ponto de vista da segurança.

Além dessa política, cada versão do Windows 11 inclui modelos ADMX/ADML específicos para o Winget que ampliam as opções de configuração no Console de Gerenciamento de Política de Grupo (GPMC). Esses modelos são organizados em categorias como controle de versão permitido, desenvolvimento local (recursos experimentais, manifestos locais) e políticas de execução e uso de proxy.

Para usar esses modelos, você pode baixar o arquivo do GitHub. DesktopAppInstallerPolicies.zip correspondente à versão do Winget que lhe interessa, extraia-a e copie os arquivos. .admx y .adml às rotas padrão de C:\Windows\PolicyDefinitions e sua subpasta de idioma. A partir daí, as novas opções aparecerão no GPMC e você poderá Aplique-as a UOs, sites ou ao domínio inteiro..

Depuração, registro e envio de novos pacotes.

Quando algo dá errado (downloads com falha, instalações que não são concluídas, conflitos de versão), o winget gera registros detalhados que são muito úteis para encontrar a origem do problema.

Você pode abrir a pasta de logs com a opção --open-logs ou ativando --verbose-logs para que a ferramenta salve mais informações sobre cada operação. O repositório oficial winget-cli Também mantém um Lista de problemas comuns e soluções recomendadas, onde é uma boa ideia dar uma olhada antes de abrir uma nova solicitação.

Se estiver faltando algum programa no catálogo, você sempre pode criar e enviar um manifesto para o repositório da comunidade. Dessa forma, ele ficará disponível não apenas para você, mas também para outros usuários e organizações, que poderão instalá-lo facilmente a partir do Winget.

A ferramenta em si é de código aberto e está localizada no repositório. microsoft/winget-cliEle foi escrito em C++ e projetado para ser compilado com o Visual Studio 2022. Se você quiser contribuir, precisará... Aceitar e assinar o Contrato de Licença de Colaborador (CLA). da Microsoft e envie as alterações de uma ramificação do seu fork.

Em última análise, conhecer e dominar o Winget permite que você trate seu PC com Windows mais como um "servidor" ou um sistema de desenvolvimento sério: tudo programável, tudo reproduzível e com controle preciso sobre o que é instalado e como , evitando cliques desnecessários e surpresas na forma de versões incompatíveis ou programas que ninguém sabe como foram parar no computador.