Отладка и устранение неполадок с средством WinGet

Статья
11/16/2024

Если WinGet не установлен правильно, выполните следующие действия из командной строки PowerShell:

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

При сбое команд WinGet иногда необходимо просмотреть файлы журналов, чтобы лучше понять поведение.

Журналы WinGet

Диспетчер пакетов Windows по умолчанию создает файлы журналов при выполнении команд. Эти журналы содержат сведения, которые могут помочь в отладке проблем с WinGet. Максимальный размер файлов журнала отсутствует. Обычно они имеют размер всего лишь нескольких КБ. Когда число файлов журнала в каталоге превышает 100, старые файлы журнала начнут удаляться. Удаление журналов на основе времени отсутствует, и эти параметры не настраиваются. Если вы достигли емкости 100 файлов, просто переместите все журналы WinGet, которые вы хотите сохранить в другом каталоге.

Используйте команду winget --info , чтобы найти путь к файлам журнала WinGet. Путь по умолчанию для файлов журнала WinGet:

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

Вы можете включить параметр --logs или --open-logs в любую команду, чтобы открыть каталог журналов после завершения команды. Ниже приведены некоторые примеры использования параметра --logs :

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

--verbose-logs

Если вам нужны более полные файлы журнала, обеспечивающие полное взаимодействие с CDN и источниками, включите в командной строке файлы --verbose или --verbose-logs в командной строке. Ниже приведены примеры использования параметра --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

Известные проблемы

Список известных проблем с источниками и поведением постоянно обновляется в репозитории клиента Диспетчера пакетов Windows. Если при использовании средства WinGet возникают проблемы, перейдите по ссылке для устранения неполадок.

Коды выхода

Средство WinGet возвращает коды выхода, указывающие на успешность или сбой команды. Найдите таблицу кодов выхода и их значения в файле "Коды возврата" репозитория клиента Диспетчер пакетов Windows.

Область для конкретного пользователя и компьютера

Не все установщики поддерживают установку в области "пользователь" и "компьютер" согласованно.

Пакеты на основе MSIX: надежное поведение WinGet.
Пакеты на основе MSI обычно поддерживают надежные конфигурации WinGet, но в некоторых случаях вложены в установщик на основе .exe, поэтому может быть более изменчивым.
Поведение установщиков на основе EXE вокруг области не обязательно детерминировано. В некоторых случаях аргументы для указания области недоступны, и в других случаях установщик может определить, является ли пользователь членом локальной группы администраторов. Для пакетов, установленных в области пользователя, может потребоваться авторизация UAC (контроль учетных записей пользователей) от администратора.

Дополнительные сведения о проблемах , связанных с областью, см. в репозитории продуктов WinGet на GitHub.

Ошибка 403 Forbidden (запрещено)

Ошибка 403 Запрещена при попытке скачать пакет с помощью средства WinGet. Эта проблема может возникнуть, если независимый поставщик программного обеспечения (ISV) не распространяет свой продукт службой диспетчера пакетов, например WinGet.

Сервер отвечает за инициирование скачивания обычно проверяет строку агента пользователя, включенную в запрос на скачивание, чтобы определить устройство или клиент (например, браузер, WinGet). Если вы можете скачать установщик с помощью браузера, но возникнут проблемы с WinGet, возможно, что isV заблокировал строку агента пользователя WinGet.

Строка агента пользователя для WinGet имеет следующий формат:

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

Пример:

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

Поделиться через