Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
La install commande de WinGet installe l’application spécifiée. Utilisez la commande search pour identifier l’application que vous souhaitez install. 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.
La install commande nécessite que vous spécifiiez la chaîne exacte à install. En cas d’ambiguïté, vous serez invité à filtrer davantage la install commande sur une application exacte.
Utilisation
winget install [[-q] <query> ...] [<options>]
Alias
Les alias suivants sont disponibles pour cette commande :
add
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 recherche de sous-chaîne insensible à la casse dans le nom du package, l’ID et le moniker. La syntaxe joker n’est pas prise en charge. Utilisez -e, --exact pour exiger une correspondance exacte (sensible à la casse). Utilisez --id, --nameou --moniker pour restreindre le champ recherché.
Paramètres
Les options vous permettent de personnaliser l’expérience install pour répondre à vos besoins.
| Choix | Descriptif |
|---|---|
| -m, --manifest | Doit être suivie du chemin du fichier manifeste (YAML). Vous pouvez utiliser le manifeste pour exécuter l’expérience install à partir d’un fichier YAML local. |
| --id | Limite install à l’ID de l’application. |
| --name | Limite la recherche au nom de l’application. |
| --moniker | Limite la recherche au moniker listé pour l’application. |
| -v, --version | Vous permet de spécifier une version exacte à install. S’il n’est pas spécifié, la dernière sera install l’application avec version la plus élevée. |
| -s, --source | Limite la recherche au source nom fourni. Doit être suivi du nom source. |
| --scope | 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électionnez l’architecture sur install. |
| --installer-type | Sélectionnez le type de programme d’installation sur install. 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, --silent | 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. |
| --custom | Arguments à transmettre au programme d’installation en plus des valeurs par défaut. |
| --override | Chaîne qui sera passée directement au programme d’installation. |
| -l, --location | Emplacement vers install (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é. |
| --allow-reboot | 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 | Recherchez les dépendances de package à l’aide de l’élément spécifié source. |
| --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 un fonctionnement totalement non interactif, combinez install avec --silent (-h). |
| --no-upgrade | Ignore la mise à niveau si une version installée existe déjà. |
| --header | En-tête HTTP REST facultatif pour Windows-Package-Manager source. |
| --authentication-mode | Spécifiez la préférence de la fenêtre d’authentification (silent, silentPreferred ou interactive). |
| --authentication-account | Indiquez le compte à utiliser pour l’authentification. |
| --accept-source-agreements | Accepte le contrat de licence du dépôt WinGet source sans afficher l’invite interactive. Ceci est distinct de toute licence de package — cela couvre les conditions d’utilisation du source lui-même, comme le dépôt communautaire 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é. |
| -?, --help | Fournit de l’aide supplémentaire sur cette commande. |
| --wait | Invite l’utilisateur à appuyer sur n’importe quelle touche avant de quitter. |
| --logs,--open-logs | Ouvre l’emplacement des journaux par défaut. |
| --verbose, --verbose-logs | 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 install plusieurs paquets dans une seule commande en répertoriant leurs identifiants 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 paquets plus volumineux, envisagez d’utiliser winget export et winget import pour enregistrer et restaurer une liste complète de paquets, ou winget configure pour install des paquets avec d’autres paramètres de la machine 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. Cela vous fournira les données supplémentaires nécessaires pour affiner la recherche du bon install.
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. Il est nécessaire de spécifier source pour lever davantage l’ambiguïté.
winget install --id Git.Git -e --source winget
Le msstoresource utilise des identificateurs uniques comme « ID » pour les packages. Celles-ci ne nécessitent pas l’option de requête exacte . Par exemple :
winget install XP9KHM4BK9FZ7Q -s msstore
Local install
L’option manifeste vous permet d’accéder à install une application en transmettant 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, --manifest | Chemin d’accès aux manifestes de l’application vers install. |
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 sera pas install.
À partir de la ligne de commande, vous pouvez accepter automatiquement les contrats en passant l’option --accept-package-agreements suivante sur la ligne de commande. Cela peut être utile pour l’écriture de scripts liés au Gestionnaire de package Windows.
Rubriques connexes
Windows developer