pin commande (winget)

La wingetpin commande vous permet de limiter les Windows Gestionnaire de package de la mise à niveau d’un package vers des plages spécifiques de versions, ou peut l’empêcher de mettre à niveau un package complètement. Un package épinglé peut toujours upgrade être mis à niveau à partir de l’extérieur du Windows Gestionnaire de package.

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é winget upgrade --all ou winget upgrade <package>vous devrez désintépiner le package pour permettre à WinGet d’effectuer un upgrade. L’option --force peut être utilisée pour remplacer le comportement de l’utilisateur pin.

• 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’utilisateur pin.

Utilisation

winget pin <subcommand> <options>

Paramètres

Les options suivantes sont disponibles.

Choix	Descriptif
-?, --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 pin commande prend en charge les sous-commandes suivantes.

Sous-commande	Descriptif
add	Ajouter un nouveau pin.
remove	Supprimer un package pin.
list	Répertorier les épingles actuelles.
reset	Réinitialiser les épingles

ajouter

La add sous-commande ajoute un nouveau pin. Cette sous-commande nécessite que vous spécifiiez le package exact à pin. En cas d’ambiguïté, vous serez invité à filtrer davantage la add sous-commande sur une application exacte.

Utilisation :

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

Les arguments

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

Paramètres

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

Choix	Descriptif
--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 exacte à pin. Le caractère générique * peut être utilisé comme suffixe de version. Modifie le pin comportement à l’être 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	Bloquer la mise à niveau jusqu’à ce que la pin suppression soit terminée, empêchant les arguments de remplacement. Modifie le pin comportement à l’être 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 pin application. L’ajout de ce pin package empêche la mise à niveau de ce package lors de l’appel 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 un blocage pin pour une application à l’aide de son ID. L’ajout d’un blocage pin empêche la mise à niveau de ce package lors de l’appel winget upgrade --all ou winget upgrade <package>. Vous devez débloquer le package pour permettre à WinGet d’effectuer un upgrade.

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

L’exemple suivant ajoute une gating pin pour une application à l’aide de son ID. L’ajout d’une gating pin empêche les mises à niveau que upgrade la version du package en dehors d’une version spécifique ou la plage de caractères génériques contrôlées.

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

enlever

La remove sous-commande supprime un pin. Cette sous-commande nécessite que vous spécifiiez le package pin exact à supprimer. En cas d’ambiguïté, vous serez invité à filtrer davantage la remove sous-commande sur une application exacte.

Utilisation :

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

Les arguments

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

Paramètres

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

Choix	Descriptif
--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 pin application.

winget pin remove powertoys

L’exemple suivant supprime une pin application à l’aide de son ID.

winget pin remove --id Microsoft.PowerToys

liste

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

Utilisation :

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

Les arguments

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

Paramètres

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

Choix	Descriptif
--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 un package pinspécifique.

winget pin list --id Microsoft.PowerToys

réinitialiser

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>]

Paramètres

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

Choix	Descriptif
--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