Como Corrigir Winget Não Reconhecido no Windows

Os usuários do Windows costumam usar o WinGet para instalar e gerenciar aplicativos através do PowerShell, Prompt de Comando e outros interpretadores. Às vezes, ao executar um comando WinGet, você pode receber um erro que diz que não é reconhecido como um cmdlet, função ou arquivo de script válido. Este guia mostra como se livrar desse erro irritante e fazer o WinGet funcionar novamente.

1. Re-Registrar ou Reparar o WinGet

Uma das maiores causas desse erro do WinGet é uma instalação corrompida ou mal configurada do Windows Package Manager. Se esse for o caso, você pode facilmente corrigir isso re-registrando o WinGet, o que irá redefinir a instalação e potencialmente corrigir quaisquer problemas que ele possa ter.

Digite PowerShell na caixa de pesquisa e clique em Executar como Administrador. Assim que abrir, copie e cole o seguinte comando no PowerShell:

Add-AppxPackage -RegisterByFamilyName -MainPackage Microsoft.DesktopAppInstaller_8wekyb3d8bbwe

O comando acima informa ao Windows para re-registrar o App Installer de sua fonte oficial da Microsoft, o que, por sua vez, restaurará a funcionalidade do WinGet.

Em vez de uma reinstalação completa, você pode reparar o pacote WinGet existente usando o seguinte comando.

Add-AppxPackage -RegisterByFamilyName -MainPackage Microsoft.DesktopAppInstaller_8wekyb3d8bbwe

Quando executado corretamente, o Windows rapidamente re-registra o aplicativo WinGet e corrige problemas do Windows Package Installer, como atalhos quebrados, dependências ausentes ou quaisquer entradas de registro corrompidas.

Relacionado: WinGet é parte de um ecossistema chamado Windows Package Manager. É uma ferramenta de linha de comando que serve como a interface do cliente para o serviço Windows Package Manager.

2. Ativar Alias de Execução de Aplicativos para o Windows Package Manager

No contexto da linha de comando, o nome WinGet é o alias de execução de aplicativo para o Windows Package Manager.

Basicamente, aliases de execução de aplicativos são comandos CLI em sua forma abreviada ou encurtada. Se você desativar esse recurso para o Windows Package Manager, isso pode fazer com que CLIs não reconheçam o WinGet. Isso também pode acontecer devido a ferramentas de limpeza de terceiros ou otimizadores de sistema.

Para ativar aliases de execução de aplicativos para o Windows Package Manager, pressione Win + I para abrir o aplicativo Configurações, vá para Aplicativos -> Configurações avançadas de aplicativos, e clique em Aliases de execução de aplicativos.

Se o interruptor para Cliente do Windows Package Manager estiver Desligado, ligue o interruptor novamente Ligado.

Os usuários do Windows 10 podem encontrar o interruptor para o Cliente do Windows Package Manager indo para Configurações -> Aplicativos -> Aplicativos e Recursos, e clicando no link Aliases de execução de aplicativos.

Dica: se você é relativamente novo no PowerShell, aprenda esses comandos essenciais.

3. Verifique se Você Tem a Última Versão do App Installer

WinGet é parte do App Installer, um pacote do Windows pré-instalado que permite aos usuários instalar e gerenciar programas facilmente. Se o App Installer apresentar falhas, isso pode levar ao erro do Winget. Para corrigir o App Installer, atualize-o pela Microsoft Store.

Vá para o link oficial de download do App Installer e clique no grande botão azul Baixar. Ele buscará um local no PC para baixar um arquivo MSIXBUNDLE.

Agora você deve ver uma mensagem de que o App Installer já está instalado. Você pode clicar em Reinstalar, o que corrigirá quaisquer dependências ausentes.

Caso contrário, você verá uma opção para atualizar pela Microsoft Store.

Você sabia? WinGet pode ser usado para baixar um navegador da web no Windows sem usar outro navegador.

4. Reinstalar o App Installer do GitHub

Se atualizar o App Installer não funcionar, talvez reinstalá-lo possa ajudar a corrigir o que está causando a falha do Winget. Para fazer isso, siga os passos abaixo:

Vá para a página do GitHub do Windows Package Manager.

Role para baixo até a seção Assets e clique no arquivo MSIXBundle do Desktop App Installer para baixá-lo.

Clique duas vezes no arquivo que você acabou de baixar e clique em Reinstalar na janela pop-up.

1. Siga o restante das instruções para concluir a reinstalação do App Installer.

FYI: não se esqueça de conferir esta lista de aplicativos do Windows que você deve desinstalar imediatamente.

5. Criar uma Variável de Ambiente de Caminho para o Winget

Quando você executa o comando WinGet no Prompt de Comando ou PowerShell, o Windows procura a variável PATH pelo arquivo que precisa para executá-lo. Em resumo, essa variável mantém uma lista de diretórios que contêm executáveis para vários comandos no Windows. Se o PATH não listar o diretório que contém os executáveis do WinGet, você encontrará o erro.

Para corrigir isso, você terá que adicionar manualmente o diretório ausente à variável PATH:

Pressione Win + R para abrir o Executar do Windows, digite systempropertiesadvanced na caixa de texto e clique em OK. Isso abrirá a janela Propriedades do Sistema.

Selecione a aba Avançado, depois clique em Variáveis de Ambiente.

Selecione a variável Path, depois clique em Editar para abrir a janela Editar variável de ambiente.

Copie o seguinte caminho de arquivo: %UserProfile\AppData\Local\Microsoft\WindowsApps.

Na janela Editar variável de ambiente, clique em Novo. Lá, você deve colar o caminho de arquivo que copiou logo acima, depois clique em OK para salvar as alterações.

Relacionado: confira uma lista completa de variáveis de ambiente do Windows.

6. Ativar Configurações de Implantação de Pacotes de Aplicativos no Editor de Política de Grupo Local

Em um dispositivo Windows Pro/Enterprise, abra a Política de Grupo digitando gpedit.msc no comando Executar.

Navegue até o seguinte caminho: Configuração do Computador -> Modelos Administrativos -> Componentes do Windows -> Implantação de Pacotes de Aplicativos.

Aqui, você encontrará um status Não configurado para a maioria dos componentes. Os que precisamos focar, particularmente, são “Permitir operações de implantação em perfis especiais” e “permitir que todos os aplicativos confiáveis sejam instalados”. Clique duas vezes nessas entidades e, na tela pop-up que se segue, clique em Habilitado, seguido de OK.

Bom saber: aprenda as diferenças entre Prompt de Comando e PowerShell.

7. Reparar o Cache do App Installer Usando Vários Métodos

Você pode reparar o cache de vários serviços. Abra o Painel de Controle e vá para Programas -> Programas e Recursos. Procure App Installer na lista.

Se você encontrar o programa listado, clique com o botão direito e escolha Reparar (ou Desinstalar, depois reinstale do GitHub como mostrado anteriormente).

Alternativamente, você pode abrir o comando Executar e digitar wsreset.exe. Isso limpará o cache da Microsoft Store, permitindo que você opere os comandos do WinGet suavemente.

8. Redefinir Seu PC com Windows para as Configurações de Fábrica

Se tudo mais falhar, pode significar que há uma corrupção ou má configuração mais profunda com seu sistema operacional em questão. Se você não souber o que fazer, redefinir o Windows para as configurações de fábrica pode ajudá-lo a começar do zero com as configurações e configurações que podem afetar o Winget. Mas antes de redefinir seu PC, certifique-se de fazer backup de seus dados importantes, pois você os perderá no processo.

Dica: aprenda qual opção é a melhor ao fazer uma redefinição do Windows: um download em nuvem ou reinstalação local.

Fazer o Winget Funcionar Novamente em Seu PC

Se você prefere instalar coisas no Prompt de Comando ou PowerShell, o Winget é uma utilidade essencial. Quando as ferramentas de linha de comando em seu PC não conseguem reconhecê-lo, isso pode prejudicar sua experiência no Windows. Seguindo os passos de solução de problemas acima, você pode fazê-lo funcionar novamente.

Se você está procurando uma alternativa ao Winget, experimente usar o Chocolatey para instalar vários aplicativos em seu PC com Windows.