commande pin (winget)

  • Article

La commande winget pin vous permet d'empêcher le gestionnaire de paquets Windows de mettre à niveau un package vers des plages de versions spécifiques, ou d'empêcher complètement la mise à niveau d'un package. Un package épinglé peut toujours être mis à niveau seul et à l’extérieur du Gestionnaire de package Windows.

Types d’épingles

WinGet prend en charge trois types d’épingles de package :

  • Épinglage : le package est exclu de winget upgrade --all mais autorise winget upgrade <package>. Vous pouvez utiliser l’argument --include-pinned pour permettre àwinget upgrade --all d’inclure des packages épinglés.

  • Blocage : le package est bloqué de winget upgrade --all ou winget upgrade <package>, vous devrez désépingler le package pour permettre à WinGet d’effectuer une mise à niveau. L’option --force peut être utilisée pour remplacer le comportement de l’épingle.

  • Liaison : le package est épinglé à une version ou une plage de versions spécifique. Vous pouvez spécifier une version exacte à laquelle vous souhaitez épingler un package ou vous pouvez utiliser le caractère générique * comme suffixe de version pour spécifier une plage de versions. Par exemple, si un package est épinglé à la version 1.2.*, toute version comprise entre 1.2.0 et 1.2.x est considérée comme valide. L’option --force peut être utilisée pour remplacer le comportement de l’épingle.

Usage

winget pin <subcommand> <options>

Options

Les options suivantes sont disponibles.

Option Description
-?, --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.

Sous-commandes

La commande pin prend en charge les sous-commandes suivantes.

Sous-commande Description
add Ajouter une nouvelle épingle.
remove Supprimer une épingle de package.
list Répertorier les épingles actuelles.
reset Réinitialiser les épingles

add

La sous-commande add ajoute une nouvelle épingle. Cette sous-commande vous oblige à spécifier le package exact à épingler. En cas d’ambiguïté, vous êtes invité à filtrer plus précisément la commande add sur une application précise.

Utilisation :

winget pin add [[-q] <query>] [<options>]

Arguments

Argument Description
-q,--query Requête utilisée pour rechercher une application.

Options

Les options vous permettent de personnaliser l’expérience d’ajout d’épingles selon vos besoins.

Option Description
--id Limite la recherche à l’ID de l’application.
--name Limite la recherche au nom de l’application.
--moniker Limite la recherche au moniker listé pour l’application.
--tag Limite la recherche aux étiquettes listées pour l’application.
--cmd, --command Limite la recherche à la commande de l’application.
-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.
-v, --version Vous permet de spécifier une version précise à épingler. Le caractère générique * peut être utilisé comme suffixe de version. Change le comportement de l’épingle pour gating.
-s, --source Limite la recherche au nom de source spécifié. Doit être suivi du nom de la source.
--header 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).
--authentication-account Indiquez le compte à utiliser pour l'authentification.
--accept-source-agreements Permet d’accepter le contrat de licence de la source et d’éviter l’invite.
--force Exécutez directement la commande et continuez avec les problèmes non liés à la sécurité.
--blocking Bloque la mise à niveau jusqu’à ce que l’épingle soit supprimée, ce qui empêche les arguments de remplacement. Change le comportement de l’épingle pour blocking.
--installed Épingle une version précise déjà installée
-?, --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

L’exemple suivant ajoute une épingle pour une application. Ajouter cette épingle empêche la mise à niveau de ce package lors de l’appel de winget upgrade --all . Utilisez l’argument --include-pinned avec winget upgrade --all pour inclure tous les packages épinglés.

winget pin add powertoys

L’exemple suivant ajoute une épingle bloquante pour une application à l’aide de son ID. Ajouter une épingle bloquante empêche la mise à niveau de ce package lors de l’appel de winget upgrade --all ou winget upgrade <package>. Vous devrez débloquer le package pour permettre à WinGet d’effectuer une mise à niveau.

winget pin add --id Microsoft.PowerToys --blocking

L’exemple suivant ajoute une épingle de passerelle à une application à l’aide de son ID. L’ajout d’une épingle de passerelle empêche les mises à niveau de la version du package en dehors d’une version spécifique ou de la plage générique indiquée dans la passerelle.

winget pin add --id Microsoft.PowerToys --version 0.70.*

remove

La sous-commande remove supprime une épingle. Cette sous-commande nécessite que vous spécifiiez l’épingle de package exacte à supprimer. En cas d’ambiguïté, vous êtes invité à filtrer plus précisément la commande uninstall sur une application exacte.

Utilisation :

winget pin remove [[-q] <query>] [<options>]

Arguments

Argument Description
-q,--query Requête utilisée pour rechercher une application.

Options

Les options vous permettent de personnaliser l’expérience d’ajout d’épingles selon vos besoins.

Option Description
--id Limite la recherche à l’ID de l’application.
--name Limite la recherche au nom de l’application.
--moniker Limite la recherche au moniker listé pour l’application.
-s, --source Limite la recherche au nom de source spécifié. Doit être suivi du nom de la source.
--tag Limite la recherche aux étiquettes listées pour l’application.
--cmd, --command Limite la recherche à la commande de l’application.
-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.
--header 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).
--authentication-account Indiquez le compte à utiliser pour l'authentification.
--accept-source-agreements Permet d’accepter le contrat de licence de la source et d’éviter l’invite.
--installed Épingle une version précise déjà installée.
-?, --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

L’exemple suivant supprime une épingle pour une application.

winget pin remove powertoys

L’exemple suivant supprime une épingle pour une application à l’aide de son ID.

winget pin remove --id Microsoft.PowerToys

list

La sous-commande list répertorie toutes les épingles actuelles.

Utilisation :

winget pin list [[-q] <query>] [<options>]

Arguments

Argument Description
-q,--query Requête utilisée pour rechercher une application.

Options

Les options vous permettent de personnaliser l’expérience d’ajout d’épingles selon vos besoins.

Option Description
--id Limite la recherche à l’ID de l’application.
--name Limite la recherche au nom de l’application.
--moniker Limite la recherche au moniker listé pour l’application.
-s, --source Limite la recherche au nom de source spécifié. Doit être suivi du nom de la source.
--tag Limite la recherche aux étiquettes listées pour l’application.
--cmd, --command Limite la recherche à la commande de l’application.
-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.
--header 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).
--authentication-account Indiquez le compte à utiliser pour l'authentification.
--accept-source-agreements Permet d’accepter le contrat de licence de la source et d’éviter l’invite.
-?, --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

L'exemple suivant affiche la liste de toutes les épingles actuelles.

winget pin list

L’exemple suivant répertorie une épingle de package spécifique.

winget pin list --id Microsoft.PowerToys

reset

La sous-commande de réinitialisation réinitialise toutes les épingles.

L’utilisation de cette sous-commande sans l’argument --force affichera les épingles qui seront supprimées.

Pour réinitialiser toutes les épingles, incluez l’argument --force .

Utilisation :

winget pin reset [<options>]

Options

Les options vous permettent de personnaliser les broches de réinitialisation en fonction de vos besoins.

Option Description
--force Exécutez directement la commande et continuez avec les problèmes non liés à la sécurité.
-s, --source Limite la recherche au nom de source spécifié. Doit être suivi du nom de la source.
-?, --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

L’exemple suivant montre toutes les épingles qi seront réinitialisées.

winget pin reset

L’exemple suivant réinitialise toutes les épingles existantes.

winget pin reset --force