Partage via


Débogage et résolution des problèmes liés à l’outil WinGet

Quand le Gestionnaire de package Windows installe, recherche ou liste des applications, il est parfois nécessaire de consulter les fichiers journaux pour mieux comprendre un comportement particulier.

Journaux WinGet

Le Gestionnaire de package Windows crée par défaut des fichiers journaux au moment de l’exécution des commandes. Ces journaux contiennent des informations qui peuvent faciliter la résolution des problèmes avec WinGet. Il n’y a pas de limite maximale de taille pour les fichiers journaux. Leur taille n’excède généralement pas quelques Ko. Lorsque le nombre de fichiers journaux dans le répertoire dépasse 100, les fichiers journaux les plus anciens commencent à être supprimés. Il n’existe aucune suppression basée sur la date des journaux et ces paramètres ne sont pas configurables. Si vous avez atteint la capacité de 100 fichiers de journaux, déplacez simplement les journaux WinGet que vous souhaitez conserver dans un autre répertoire.

Utilisez la commande winget --info pour rechercher le chemin d’accès au répertoire de vos fichiers journaux WinGet. Le chemin d’accès par défaut pour les fichiers journaux WinGet est le suivant :

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

Vous pouvez inclure l’option --logs ou --open-logs à n’importe quelle commande pour ouvrir le répertoire des journaux une fois la commande terminée. Voici quelques exemples d’utilisation de l’option --logs :

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

--verbose-logs

Si vous avez besoin de fichiers journaux plus complets, qui fournissent une communication complète avec les CDN et les sources, incluez également --verbose ou --verbose-logs sur la ligne de commande. Voici quelques exemples d’utilisation de l’option --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

Problèmes connus

Une liste de problèmes connus liés aux sources et aux comportements est tenue à jour dans le dépôt du client Gestionnaire de package Windows. Si vous rencontrez des problèmes durant l’utilisation de l’outil WinGet, vous trouverez ici des informations sur leur résolution.

Codes de sortie

L’outil WinGet retourne des codes de sortie pour indiquer la réussite ou l’échec de la commande. Recherchez une table des codes de sortie et leurs significations dans le fichier « Codes de retour » du référentiel client du Gestionnaire de package Windows.

Étendue pour un utilisateur spécifique ou à l’échelle de l’ordinateur

Les programmes d’installation ne prennent pas tous en charge l’installation dans l’étendue « utilisateur » ou l’étendue « ordinateur » de manière cohérente.

  • Packages basés sur MSIX : Comportement WinGet fiable.
  • Les packages basés sur MSI prennent généralement en charge les configurations WinGet fiables, mais dans certains cas, ils sont imbriqués dans un programme d’installation basé sur .exe, ce qui peut entraîner plus d’instabilité.
  • Le comportement des programmes d’installation basés sur EXE autour de l’étendue n’est pas nécessairement déterministe. Dans certains cas, les arguments permettant de spécifier l’étendue ne sont pas disponibles, tandis que dans d’autres cas, le programme d’installation peut déterminer si l’utilisateur est membre du groupe Administrateurs local. Les packages installés dans l’étendue de l’utilisateur peuvent quand même nécessiter l’autorisation UAC (Contrôle de compte d’utilisateur) d’un administrateur.

Pour plus d’informations sur les problèmes liés aux étendues, consultez le dépôt de produits WinGet sur GitHub.