Fouten opsporen en problemen oplossen met het WinGet-hulpprogramma

Als WinGet niet correct lijkt te zijn geïnstalleerd, volgt u deze stappen vanuit een PowerShell-opdrachtprompt:

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

Wanneer WinGet-opdrachten mislukken, is het soms nodig om de logboekbestanden te bekijken om het gedrag beter te begrijpen.

WinGet-logboeken

Windows Pakketbeheer maakt standaard logboekbestanden bij het uitvoeren van opdrachten. Deze logboeken bevatten informatie die kan helpen bij het opsporen van fouten met WinGet. Het gedrag voor het opschonen van logboekbestanden kan worden geconfigureerd via de logboekregistratie settings in uw settings bestand. Standaard worden logboekbestanden die ouder zijn dan 7 dagen of meer dan 128 MB automatisch verwijderd en worden afzonderlijke logboekbestanden verpakt op 16 MB. Gebruik de logging.filesettings functie om deze limieten aan te passen.

Gebruik de opdracht winget --info om het mappad naar uw WinGet-logboekbestanden te vinden. Het standaardpad voor WinGet-logboekbestanden is:

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

U kunt de --logs of --open-logs optie voor elke opdracht opnemen om de logboekmap te openen nadat de opdracht is voltooid. Hier volgen enkele voorbeelden van het gebruik van de --logs optie:

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

--verbose-logs

Als u uitgebreidere logboekbestanden nodig hebt die de volledige communicatie met de CDN's en bronnen bevatten, neemt u ook --verbose of --verbose-logs op in de opdrachtregel. Hier volgen enkele voorbeelden van het gebruik van de --verbose-logs optie:

> 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

settings

U kunt het standaard loggingniveau opgeven dat door WinGet moet worden gebruikt in uw WinGet-instellingenbestand. Met settings de opdracht wordt het settings.json-bestand in uw standaard-JSON-editor geopend.

Voorbeeld met uitgebreide logboekregistratie:

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

Bekende problemen

Een list van bekende problemen met bronnen en gedragingen wordt actueel gehouden in de Windows Pakketbeheer Client-repository. Als u problemen ondervindt bij het gebruik van het WinGet-hulpprogramma, gaat u hier voor probleemoplossing.

Afsluitcodes

Het WinGet-hulpprogramma retourneert afsluitcodes om aan te geven dat de opdracht is geslaagd of mislukt. Zoek een tabel met afsluitcodes en de betekenis ervan in het bestand Retourcodes van de Windows Pakketbeheer Client-opslagplaats.

De WinGet-foutopdracht accepteert fouten uit 'Afsluitcodes' en geeft een beschrijving weer voor bekende foutcodes voor WinGet-, MSIX- en MSI-installatieprogramma's. Veel .exe-gebaseerde installatieprogramma's hebben niet-standaardfoutcodes en worden mogelijk niet weergegeven.

> winget error 1603

Bereik voor specifieke gebruiker versus machinebreed

Niet alle installatieprogramma's ondersteunen consistent het installeren als 'gebruiker' of als 'machine'.

• MSIX-pakketten: Betrouwbaar WinGet-gedrag.
• MSI-pakketten ondersteunen doorgaans betrouwbare WinGet-configuraties, maar in sommige gevallen zijn genest in een .exe-gebaseerd installatieprogramma, zodat er mogelijk meer variabiliteit is.
• EXE-gebaseerde installatieprogramma's hebben een gedrag met betrekking tot het bereik dat niet noodzakelijkerwijs deterministisch is. In sommige gevallen zijn de argumenten voor het opgeven van het bereik niet beschikbaar. In andere gevallen kan het installatieprogramma bepalen of de gebruiker lid is van de lokale beheerdersgroep. Voor pakketten die in het gebruikersbereik zijn geïnstalleerd, is mogelijk nog steeds UAC-autorisatie (Gebruikersaccountbeheer) vereist van een beheerder.

Zie meer details over bereikgerelateerde problemen in de WinGet-repository op GitHub.

Fout: 403 Verboden

Er kan een fout 403 Verboden optreden bij het downloaden van een pakket met behulp van het WinGet-hulpprogramma. Dit probleem kan zich voordoen als een onafhankelijke softwareleverancier (ISV) ervoor kiest om het product niet te distribueren door een package manager-service zoals WinGet.

De server die verantwoordelijk is voor het initiëren van de download controleert doorgaans op een gebruikersagenttekenreeks die is opgenomen in de downloadaanvraag om het apparaat of de client te identificeren (bijvoorbeeld browser, WinGet). Als u het installatieprogramma kunt downloaden met behulp van uw browser, maar problemen ondervindt met WinGet, is het mogelijk dat de ISV de tekenreeks van de WinGet-gebruikersagent heeft geblokkeerd.

De tekenreeks van de gebruikersagent voor WinGet heeft de volgende indeling:

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

Voorbeeld:

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

Systeemcontext

WinGet wordt geleverd via het app-installatieprogramma als een verpakte toepassing. MSIX-toepassingen in pakketvorm vereisen dat het pakket voor de gebruiker is geregistreerd. Aangezien pakketten kunnen worden geregistreerd voor elke gebruiker behalve NT AUTHORITY\SYSTEM (ook wel LocalSystem, aka System), wordt de WinGet CLI niet ondersteund in de systeemcontext. De PowerShell-module Microsoft.WinGet.Client kan worden gebruikt in de systeemcontext met toepassingen die op een computer zijn geïnstalleerd.