upgrade commande (winget)

La upgrade commande de l’outil WinGet met à niveau l’application spécifiée. Si vous le souhaitez, vous pouvez utiliser la commande list pour identifier l’application que vous souhaitez upgrade.

La upgrade commande nécessite que vous spécifiiez la chaîne exacte à upgrade. En cas d’ambiguïté, vous serez invité à filtrer davantage la upgrade commande sur une application exacte.

Alias

Les alias suivants sont disponibles pour cette commande :

• update

Utilisation

winget upgrade [[-q] <query> ...] [<options>]

Les arguments

Les arguments suivants sont disponibles.

Raisonnement	Descriptif
-q,--query	Requête utilisée pour rechercher une application.

Note

L’argument de requête est positionnel. La syntaxe à base de caractères génériques n’est pas prise en charge. Il s’agit le plus souvent de la chaîne de caractères qui doit vous permettre de trouver le package que vous mettez à niveau.

Paramètres

Les options vous permettent de personnaliser l’expérience upgrade pour répondre à vos besoins.

Choix	Descriptif
-m, --manifeste	Doit être suivie du chemin du fichier manifeste (YAML). Vous pouvez utiliser le manifeste pour exécuter l’expérience upgrade à partir d’un fichier YAML local.
--id	Limite upgrade à 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 exacte à upgrade. S’il n’est pas spécifié, la dernière sera upgrade l’application avec version la plus élevée.
-s, --source	Limite la recherche au nom de source spécifié. Doit être suivi du nom de la source.
-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.
--purge	Supprime tous les fichiers et répertoires du répertoire des packages (portable)
-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 vers upgrade (si pris en charge).
--étendue	Sélectionne le filtre d’étendue du package installé (utilisateur ou ordinateur).
a, --architecture	Sélectionne l’architecture à installer.
--installer-type	Sélectionnez le type de programme d’installation sur upgrade. Consultez les types de programmes d’installation pris en charge pour le client WinGet.
--locale	Spécifie les paramètres régionaux à utiliser (format BCP47).
--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.
--accept-package-agreements	Permet d’accepter le contrat de licence et d’éviter l’invite.
--accept-source-agreements	Permet d’accepter le contrat de licence de la source et d’éviter l’invite.
--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.
-r, --recurse, --all	Mettez à jour tous les packages installés vers la dernière version si elle est disponible.
-u, --unknown (inconnu), --include-unknown (inclure les inconnus)	Met à niveau des packages même si leur version actuelle ne peut pas être déterminée.
--pinned,--include-pinned	Met à niveau les packages même s’ils ont un repère non bloquant.
--uninstall-previous	Désinstallez la version précédente du package pendant upgrade. Le comportement dépend du package individuel. Certains programmes d’installation sont conçus pour installer les nouvelles versions côte à côte. Certains programmes d’installation incluent un manifeste qui spécifie « uninstallPrevious » afin que les versions antérieures soient désinstallées sans avoir à utiliser cet indicateur de commande. Dans ce cas, l’utilisation de la commande winget upgrade --uninstall-previous indique à WinGet de désinstaller la version précédente, quel que soit le contenu du manifeste du package. Si le manifeste du package n’inclut pas « uninstallPrevious » et que l’indicateur --uninstall-previous n’est pas utilisé, le comportement par défaut du programme d’installation s’applique.
--force	Exécute directement la commande et poursuit avec les problèmes non liés à la sécurité.
-?,--help	Affiche une aide sur la commande sélectionnée.
--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 répertorie les applications avec une upgrade version disponible.

winget upgrade

L’exemple suivant met à niveau une version spécifique d’une application.

winget upgrade powertoys --version 0.15.2

L’exemple suivant met à niveau une application à partir de son ID.

winget upgrade --id Microsoft.PowerToys

L’exemple suivant montre la mise à niveau de toutes les applications.

winget upgrade --all

L’exemple suivant illustrera upgrade plusieurs applications.

winget upgrade Microsoft.Edit Microsoft.NuGet

Utilisation de upgrade

Pour identifier les applications qui ont besoin d’un update, utilisez upgrade simplement sans arguments pour afficher toutes les mises à niveau disponibles.

upgrade --all

upgrade --all installera upgrade toutes les applications qui disposent d’une version disponible update. Lorsque vous exécutez wingetupgrade --all, le Windows Gestionnaire de package recherche toutes les applications qui ont des mises à jour disponibles et tente d’installer les mises à jour. Utilisez upgrade sans arguments pour afficher un aperçu des applications qui seront mises à niveau.

Note

Certaines applications ne fournissent pas de version. Elles sont toujours à jour. Étant donné que le Windows Gestionnaire de package ne peut pas identifier s’il existe une version plus récente de l’application, une option upgrade ne sera pas possible, sauf si l’option -u, --unknown, --include-unknown est spécifiée.

Note

Certaines applications ont peut-être été épinglées à l’aide de WinGet et ne seront pas mises à niveau si l’option --all est spécifiée, sauf si l’option --include-pinned est spécifiée. Dans ce cas, seuls les repères non bloquants des applications sont mis à niveau.

upgrade --uninstall-previous

upgrade --uninstall-previous désinstalle la version précédente avant d’installer la version la plus récente du package. Lorsque vous utilisez --uninstall-previous, le comportement dépend du package individuel. Certains programmes d’installation sont conçus pour installer de nouvelles versions côte à côte, tandis que d’autres programmes d’installation incluent un manifeste qui spécifie leur comportement par défaut uninstallPrevious (de sorte que les versions antérieures upgrade sont désinstallées sans avoir à utiliser l’indicateur de commande).

Si le manifeste du package n’inclut uninstallPrevious pas comme comportement et que upgrade l’indicateur --uninstall-previous n’est pas utilisé avec la upgrade commande, le comportement par défaut du programme d’installation s’applique.