commande pin (winget)

La commande wingetpin 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.

Utilisation

winget pin <subcommand> <options>

Paramètres

Les options suivantes sont disponibles.

Choix	Descriptif
-?--Aide	Fournit de l’aide supplémentaire sur cette commande.
--attendre	Invite l’utilisateur à appuyer sur n’importe quelle touche avant de quitter.
--logs,--ouvre-journaux	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.
--désactiver-interactivité	Désactivez les invites interactives.
--procuration	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	Descriptif
ajouter	Ajouter une nouvelle épingle.
supprimer	Supprimer une épingle de package.
liste	Répertorier les épingles actuelles.
réinitialiser	Réinitialiser les épingles

ajouter

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

Les arguments

Raisonnement	Descriptif
-q,--requête	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.
--nom	Limite la recherche au nom de l’application.
--sobriquet	Limite la recherche au moniker listé pour l’application.
--étiquette	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.
--en-tête	En-tête HTTP facultatif de la source REST du Gestionnaire de package Windows.
--mode-authentication	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.
--acceptation-des-accords-source	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é.
--bloquant	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.
--installé	Épingle une version précise déjà installée
-?--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.
--désactiver-interactivité	Désactivez les invites interactives.
--procuration	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.*

enlever

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

Les arguments

Raisonnement	Descriptif
-q,--requête	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.
--nom	Limite la recherche au nom de l’application.
--sobriquet	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.
--étiquette	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.
--en-tête	En-tête HTTP facultatif de la source REST du Gestionnaire de package Windows.
--mode-authentication	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.
--acceptation-des-accords-source	Permet d’accepter le contrat de licence de la source et d’éviter l’invite.
--installé	Épingle une version précise déjà installée.
-?--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.
--désactiver-interactivité	Désactivez les invites interactives.
--procuration	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

liste

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

Utilisation :

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

Les arguments

Raisonnement	Descriptif
-q,--requête	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.
--nom	Limite la recherche au nom de l’application.
--sobriquet	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.
--étiquette	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.
--en-tête	En-tête HTTP facultatif de la source REST du Gestionnaire de package Windows.
--mode-authentication	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.
--acceptation-des-accords-source	Permet d’accepter le contrat de licence de la source et d’éviter l’invite.
-?--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.
--désactiver-interactivité	Désactivez les invites interactives.
--procuration	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

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.
-?--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.
--désactiver-interactivité	Désactivez les invites interactives.
--procuration	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