Debugowanie i rozwiązywanie problemów z narzędziem WinGet

Jeśli polecenie WinGet nie jest poprawnie zainstalowane, wykonaj następujące kroki z wiersza polecenia programu PowerShell:

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

Gdy polecenia WinGet kończą się niepowodzeniem, czasami należy przyjrzeć się plikom dziennika, aby lepiej zrozumieć zachowanie.

Dzienniki WinGet

Menedżer pakietów systemu Windows domyślnie tworzy pliki dziennika podczas wykonywania poleceń. Te dzienniki zawierają informacje, które mogą pomóc w debugowaniu problemów z usługą WinGet. Brak maksymalnego rozmiaru plików dziennika. Zazwyczaj są to tylko kilka KB rozmiaru. Gdy liczba plików dziennika w katalogu przekroczy 100, najstarsze pliki dziennika zaczną być usuwane. Nie ma czasu usunięcia dzienników i te ustawienia nie są konfigurowalne. Jeśli osiągnięto pojemność dziennika plików 100, po prostu przenieś wszystkie dzienniki WinGet, które chcesz zachować w innym katalogu.

Użyj polecenia winget --info , aby znaleźć ścieżkę katalogu do plików dziennika WinGet. Domyślna ścieżka dla plików dziennika WinGet to:

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

Możesz dołączyć opcję --logs lub --open-logs do dowolnego polecenia, aby otworzyć katalog logs po zakończeniu polecenia. Oto kilka przykładów użycia opcji --logs :

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

--verbose-logs (szczegółowe logi)

Jeśli potrzebujesz bardziej kompleksowych plików dziennika, które dostarczają pełną komunikację z sieciami CDN i źródłami, uwzględnij --verbose lub --verbose-logs w wierszu polecenia. Poniżej przedstawiono kilka przykładów użycia opcji --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

ustawienia

Możesz określić domyślny poziom rejestrowania dla winGet do użycia w pliku ustawień WinGet. Polecenie ustawień spowoduje otwarcie pliku settings.json w domyślnym edytorze JSON.

Przykład z rozbudowanym rejestrowaniem:

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

Znane problemy

Lista znanych problemów ze źródłami i zachowaniami jest aktualna w repozytorium klienta Menedżera pakietów systemu Windows. Jeśli wystąpią problemy podczas korzystania z narzędzia WinGet, przejdź tutaj , aby rozwiązać problemy.

Kody zakończenia

Narzędzie WinGet zwraca kody zakończenia, aby wskazać powodzenie lub niepowodzenie polecenia. Znajdź tabelę kodów zakończenia i ich znaczenie w pliku "Kody powrotne" repozytorium klienta Menedżera pakietów systemu Windows.

Polecenie error WinGet akceptuje błędy z „kodów zakończenia” i wyświetla opis znanych kodów dla instalatorów WinGet, MSIX i MSI. Wiele instalatorów opartych na .exema niestandardowe kody błędów i mogą nie być wyświetlane.

> winget error 1603

Zakres dla określonego użytkownika a dla całego komputera

Nie wszystkie instalatory konsekwentnie obsługują instalację w trybie "użytkownika" lub "systemu".

• Pakiety oparte na MSIX: niezawodne zachowanie WinGet.
• pakiety oparte na MSI zwykle obsługują niezawodne konfiguracje WinGet, ale w niektórych przypadkach są zagnieżdżone wewnątrz instalatora opartego na .exe, dzięki czemu może występować większa zmienność.
• Instalatory oparte na plikach EXE mają zachowanie w zakresie, które niekoniecznie jest deterministyczne. W niektórych przypadkach argumenty określające zakres nie są dostępne, a w innych przypadkach instalator może określić, czy użytkownik jest członkiem lokalnej grupy administratorów. Pakiety zainstalowane w zakresie użytkownika mogą nadal wymagać zgody administratora na autoryzację UAC (kontrola konta użytkownika).

Zobacz więcej szczegółów na temat problemów związanych z zakresem w repozytorium produktu WinGet na GitHubie.

Błąd 403 Zabronione

Podczas próby pobrania pakietu przy użyciu narzędzia WinGet może wystąpić błąd 403 Zabronione. Ten problem może wystąpić, jeśli niezależny dostawca oprogramowania (ISV) nie zdecyduje się na dystrybucję produktu przez usługę menedżera pakietów, taką jak WinGet.

Serwer odpowiedzialny za zainicjowanie pobierania zwykle sprawdza ciąg agenta użytkownika dołączony do żądania pobierania w celu zidentyfikowania urządzenia lub klienta (np. przeglądarki, WinGet). Jeśli możesz pobrać instalator przy użyciu przeglądarki, ale napotkasz problemy z WinGet, możliwe, że niezależny dostawca oprogramowania zablokował ciąg agenta użytkownika WinGet.

Ciąg agenta użytkownika dla WinGet ma następujący format:

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

Przykład:

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

Kontekst systemu

WinGet jest dostarczany za pośrednictwem Instalatora aplikacji jako spakowanej aplikacji. Aplikacje MSIX (spakowane) zależą od aliasu wykonywania aplikacji, który ma zostać rozpoznany w zmiennej środowiskowej PATH. CLI WinGet nie jest obsługiwane w kontekście systemowym. Moduł Microsoft.WinGet.Client programu PowerShell może być używany w kontekście systemu z aplikacjami zainstalowanymi na całym komputerze.