Remarque
L’accès à cette page requiert une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page requiert une autorisation. Vous pouvez essayer de modifier des répertoires.
La commande d’installation de WinGet installe l’application spécifiée. Utilisez la commande search pour identifier l’application que vous souhaitez installer. Utilisez la commande Show pour afficher des détails sur l’application et le programme d’installation sélectionné par WinGet pour votre système.
Avec la commande install, vous devez entrer la chaîne exacte à utiliser pour l’installation. En cas d’ambiguïté, vous êtes invité à filtrer plus précisément la commande install sur une application exacte.
Utilisation
winget install [[-q] <query> ...] [<options>]
Alias
Les alias suivants sont disponibles pour cette commande :
- ajouter
Les arguments
Les arguments suivants sont disponibles.
| Raisonnement | Descriptif |
|---|---|
| -q,--query | Requête utilisée pour rechercher une application. |
Remarque
L’argument de requête est positionnel. Par défaut, winget effectue une correspondance de sous-chaîne insensible à la casse par rapport au nom du package, à l'ID et au moniker. La syntaxe joker n’est pas prise en charge. Utilisez -e, --exact pour exiger une correspondance exacte (sensible à la casse). Utilisez --id, --name ou --moniker pour restreindre le champ recherché.
Paramètres
Les options vous permettent de personnaliser l’expérience d’installation en fonction de vos besoins.
| Choix | Descriptif |
|---|---|
| -m, --manifeste | Doit être suivie du chemin du fichier manifeste (YAML). Vous pouvez utiliser le manifeste pour exécuter l’installation à partir d’un fichier YAML local. |
| --id | Limite l’installation à l’ID de l’application. |
| --name | Limite la recherche au nom de l’application. |
| --sobriquet | Limite la recherche au moniker listé pour l’application. |
| -v, --version | Vous permet de spécifier une version précise à installer. Si aucune version n’est spécifiée, la version la plus récente de l’application est installée. |
| -s, --source | Limite la recherche au nom de source spécifié. Doit être suivi du nom de la source. |
| --étendue | Vous permet de spécifier si le programme d’installation doit cibler l’étendue de l’utilisateur ou de l’ordinateur. Consultez Problèmes connus liés à l’étendue de l’installation du package. |
| -a, --architecture | Sélectionne l’architecture à installer. |
| --installer-type | Sélectionnez le type de programme d’installation à installer. Consultez les types de programmes d’installation pris en charge pour le client WinGet. |
| -e, --exact | Utilise la chaîne exacte dans la requête, y compris la vérification du respect de la casse. Elle n’utilise pas le comportement par défaut d’une sous-chaîne. |
| -i, --interactive | Exécute le programme d’installation en mode interactif. L’expérience par défaut montre la progression du programme d’installation. |
| -h, --silencieux | Exécute le programme d’installation en mode silencieux. Vous ne voyez aucune invite s’afficher. L’expérience par défaut montre la progression du programme d’installation. |
| --locale | Spécifie les paramètres régionaux à utiliser (format BCP47). |
| -o, --log | Dirige la journalisation vers un fichier journal spécifique. Vous devez fournir le chemin d’un fichier sur lequel vous disposez des droits d’écriture. |
| --coutume | Arguments à transmettre au programme d’installation en plus des valeurs par défaut. |
| --écraser | Chaîne qui sera passée directement au programme d’installation. |
| -l, --location | Emplacement d’installation (si pris en charge). |
| --ignore-security-hash | Ignore l’échec de la vérification du hachage du programme d’installation. Cela n’est pas recommandé. |
| --autoriser-redémarrage | Permet un redémarrage le cas échéant. |
| --skip-dependencies | Ne traite pas les dépendances des packages et les fonctionnalités de Windows. |
| --ignore-local-archive-malware-scan | Ignore l’analyse des programmes malveillants effectuée dans le cadre de l’installation d’un package de type d’archive à partir du manifeste local. |
| --dependency-source | Recherche les dépendances de package à l’aide de la source spécifiée. |
| --accept-package-agreements | Accepte les contrats de licence ou les CLUF présentés par le programme d’installation du package, en supprimant l’invite interactive. Cela s’applique uniquement aux propres termes du contrat de licence du package : il n’affecte pas les composants facultatifs ou les logiciels groupés proposés par le programme d’installation. Pour une installation entièrement non interactive, combinez --silent (-h). |
| --no-upgrade | Ignore la mise à niveau si une version installée existe déjà. |
| --en-tête | En-tête HTTP facultatif de la source REST du Gestionnaire de package Windows. |
| --authentication-mode | Spécifiez la préférence de la fenêtre d’authentification (silent, silentPreferred ou interactive). |
| --compte-authentification | Indiquez le compte à utiliser pour l’authentification. |
| --accept-source-agreements | Accepte le contrat de licence pour la source WinGet (référentiel), en supprimant l’invite interactive. Il s’agit d’une licence de package distincte de n’importe quelle licence de package : elle couvre les conditions d’utilisation de la source elle-même, telles que le référentiel de la communauté winget. |
| -r, --rename | Valeur pour renommer le fichier exécutable (portable). |
| --uninstall-previous | Désinstalle la version précédente du package pendant la mise à niveau. |
| --force | Exécutez directement la commande et continuez avec les problèmes non liés à la sécurité. |
| -?--Aide | Fournit de l’aide supplémentaire sur cette commande. |
| --attendre | Invite l’utilisateur à appuyer sur n’importe quelle touche avant de quitter. |
| --logs,--open-logs | Ouvre l’emplacement des journaux par défaut. |
| --verbose (mode détaillé), --verbose-logs (journaux détaillés) | Utilisé pour remplacer le paramètre de journalisation et créer un journal détaillé. |
| --nowarn,--ignore-warnings | Supprime les sorties d’avertissement. |
| --disable-interactivity | Désactivez les invites interactives. |
| --proxy | Définissez un proxy à utiliser pour cette exécution. |
| --no-proxy | Désactive l’utilisation du proxy pour cette exécution. |
Exemples de requêtes
L’exemple suivant installe une version spécifique d’une application.
winget install powertoys --version 0.91.1
L’exemple suivant installe une application à partir de son ID.
winget install --id Microsoft.PowerToys
L’exemple suivant installe une application par version et ID.
winget install --id Microsoft.PowerToys --version 0.91.1
Installer plusieurs packages
Vous pouvez installer plusieurs packages dans une seule commande en répertoriant leurs ID séparés par des espaces.
winget install Microsoft.VisualStudioCode Microsoft.PowerShell Git.Git
WinGet installe chaque package en séquence. Cela est utile pour configurer rapidement un nouvel ordinateur ou partager un ensemble d’outils avec un collègue.
Conseil / Astuce
Pour les ensembles de packages plus volumineux, envisagez d’utiliser l’exportation winget et l’importation winget pour enregistrer et restaurer une liste de packages complète, ou configurer winget pour installer des packages en même temps que d’autres configurations d’ordinateur dans un seul fichier.
Désambiguer les résultats
Si la requête fournie à WinGet n’entraîne pas d’application unique, WinGet affiche les résultats de la recherche. Vous avez alors les données supplémentaires nécessaires pour affiner la recherche d’une installation correcte.
La meilleure façon de limiter la sélection à un seul fichier est d’utiliser l’id de l’application et le combiner à l’option de requête exact. Par exemple :
winget install --id Git.Git -e
Si plusieurs sources sont configurées, il est possible d’avoir des entrées en double. La spécification d’une source est nécessaire pour lever toute ambiguïté.
winget install --id Git.Git -e --source winget
La source msstore utilise des identificateurs uniques en tant qu’« ID » pour les packages. Celles-ci ne nécessitent pas l’option de requête exacte . Par exemple :
winget install XP9KHM4BK9FZ7Q -s msstore
Installation locale
L’option manifest vous permet d’installer une application en passant un fichier YAML directement au client. Si le manifeste est un manifeste à plusieurs fichiers, le répertoire contenant les fichiers doit être utilisé. L’option manifest s’utilise de la manière suivante.
Utilisation : winget install --manifest \<path>
| Choix | Descriptif |
|---|---|
| -m, --manifeste | Chemin des manifestes de l’application à installer. |
L’installation de packages à partir de fichiers manifeste locaux peut comporter des risques. Par mesure de précaution supplémentaire, cette fonctionnalité doit être activée par un administrateur. Pour activer cette fonctionnalité, exécutez winget settings --enable LocalManifestFiles. Pour désactiver cette fonctionnalité, exécutez winget settings --disable LocalManifestFiles.
Fichiers journaux
Les fichiers journaux pour WinGet, sauf s’ils sont redirigés, se trouvent dans le dossier suivant : \%LOCALAPPDATA%\\Packages\\Microsoft.DesktopAppInstaller_8wekyb3d8bbwe\\LocalState\\DiagOutputDir\\*.log
Contrats de licence
Certaines applications imposent à l’utilisateur d’accepter la licence ou d’autres contrats avant de pouvoir être installées. Dans ce cas, le Gestionnaire de package Windows invite l’utilisateur à accepter les contrats. Si l’utilisateur n’est pas d’accord, l’application ne s’installe pas.
À partir de la ligne de commande, vous pouvez accepter automatiquement les contrats en passant l’option suivante --accept-package-agreements sur la ligne de commande. Cela peut être utile pour l’écriture de scripts liés au Gestionnaire de package Windows.
Rubriques connexes
Collaborer avec nous sur GitHub
La source de ce contenu se trouve sur GitHub, où vous pouvez également créer et examiner des problèmes et des demandes de tirage (pull requests). Pour plus d’informations, consultez notre guide du contributeur.
Windows developer