Depuração e resolução de problemas na utilização da ferramenta WinGet

Se o WinGet não parecer estar instalado corretamente, siga estas etapas em um prompt de comando do PowerShell:

Install-PackageProvider -Name NuGet -Force | Out-Null
Install-Module -Name Microsoft.WinGet.Client -Force -Repository PSGallery | Out-Null
Repair-WinGetPackageManager -Force -Latest

Quando os comandos do WinGet estão falhando, às vezes é necessário examinar os arquivos de log para entender melhor o comportamento.

Registos do WinGet

O Gerenciador de Pacotes do Windows por padrão cria arquivos de log ao executar comandos. Esses logs contêm informações que podem ajudar na depuração de problemas com o WinGet. Não há tamanho máximo para os arquivos de log. Normalmente, eles têm apenas alguns KB de tamanho. Quando o número de arquivos de log no diretório exceder 100, os arquivos de log mais antigos começarão a ser excluídos. Não há remoção de logs com base no tempo e essas configurações não são configuráveis. Se você atingiu a capacidade de log de 100 arquivos, basta mover todos os logs do WinGet que você deseja preservar para um diretório diferente.

Use o comando winget --info para localizar o caminho do diretório para seus arquivos de log do WinGet. O caminho padrão para arquivos de log do WinGet é:

%LOCALAPPDATA%\Packages\Microsoft.DesktopAppInstaller_8wekyb3d8bbwe\LocalState\DiagOutputDir

Você pode incluir a opção --logs ou --open-logs em qualquer comando para abrir o diretório logs após a conclusão do comando. Aqui estão alguns exemplos de uso da opção --logs :

> winget list --logs
> winget source update --open-logs

--Logs verbosos

Se você precisar de arquivos de log mais abrangentes, que forneçam a comunicação completa com as CDNs e fontes, inclua --verbose ou --verbose-logs na linha de comando também. Aqui estão alguns exemplos de como usar a opção --verbose-logs:

> winget install vscode --verbose-logs
> winget search -n visual --verbose-logs
> winget source add -n mysource -t Microsoft.REST -a https://www.contoso.org --verbose

definições

Você pode especificar o nível de log padrão para o WinGet usar em seu arquivo de configurações do WinGet. O comando settings abrirá o arquivo settings.json em seu editor JSON padrão.

Exemplo com registro detalhado:

{
    "$schema": "https://aka.ms/winget-settings.schema.json",
    "logging": {
        "level": "verbose"
    }
}

Problemas conhecidos

Uma lista de problemas conhecidos com origens e comportamentos é mantida atualizada no repositório do Cliente do Gerenciador de Pacotes do Windows. Se você encontrar problemas ao usar a ferramenta WinGet, vá aqui para solucionar problemas.

Códigos de saída

A ferramenta WinGet retorna códigos de saída para indicar o sucesso ou falha do comando. Encontre uma tabela de códigos de saída e seus significados no arquivo "Códigos de retorno" do repositório do Windows Package Manager Client.

O comando WinGet erro aceita códigos de erro de "Códigos de saída" e exibe uma descrição para códigos de erro conhecidos de instaladores WinGet, MSIX e MSI. Muitos instaladores baseados em .exetêm códigos de erro não padrão e podem não ser exibidos.

> winget error 1603

Escopo para usuário específico vs toda a máquina

Nem todos os instaladores suportam de forma consistente a instalação no escopo "usuário" versus "máquina".

• Pacotes baseados em MSIX: Confiável comportamento do WinGet.
• pacotes baseados em MSI normalmente suportam configurações confiáveis do WinGet, mas, em alguns casos, são aninhados dentro de um instalador baseado em .exe, portanto, pode haver mais variabilidade.
• O comportamento dos instaladores baseados em EXE em relação ao escopo não é necessariamente determinístico. Em alguns casos, os argumentos para especificar o escopo não estão disponíveis e, em outros casos, o instalador pode fazer a determinação com base no fato de o usuário ser membro do grupo de administradores locais. Os pacotes instalados no escopo do usuário ainda podem exigir autorização do UAC (Controle de Conta de Usuário) de um administrador.

Veja mais detalhes sobre problemas relacionados ao escopo no repositório de produtos WinGet no GitHub.

Erro 403 Proibido

Um erro 403 Forbidden pode ocorrer ao tentar baixar um pacote usando a ferramenta WinGet. Esse problema pode surgir se um fornecedor independente de software (ISV) optar por não ter seu produto distribuído por um serviço de gerenciador de pacotes como WinGet.

O servidor responsável por iniciar o download normalmente verifica se há uma cadeia de caracteres de agente do usuário incluída na solicitação de download para identificar o dispositivo ou cliente (por exemplo, navegador, WinGet). Se você pode baixar o instalador usando seu navegador, mas encontrar problemas com o WinGet, é possível que o ISV tenha bloqueado a cadeia de caracteres do agente do usuário WinGet.

A cadeia de caracteres do agente do usuário para WinGet tem o seguinte formato:

winget-cli WindowsPackageManager/{Client Version} DesktopAppInstaller/Microsoft.DesktopAppInstaller {AppInstaller Version}

Exemplo:

winget-cli WindowsPackageManager/1.9.25200 DesktopAppInstaller/Microsoft.DesktopAppInstaller v1.24.25200.0

Contexto do sistema

WinGet é fornecido através do App Installer como um aplicativo empacotado. Os aplicativos MSIX (empacotados) dependem de um Alias de Execução de Aplicativo para serem resolvidos na variável de ambiente PATH. A CLI do WinGet não é suportada no contexto do sistema. O módulo Microsoft.WinGet.Client PowerShell pode ser usado no contexto do sistema com aplicativos instalados em toda a máquina.