commande pin (winget)
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 --allmais autorisewinget upgrade <package>. Vous pouvez utiliser l’argument--include-pinnedpour permettre àwinget upgrade --alld’inclure des packages épinglés.Blocage : le package est bloqué de
winget upgrade --allouwinget upgrade <package>, vous devrez désépingler le package pour permettre à WinGet d’effectuer une mise à niveau. L’option--forcepeut ê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 version1.2.*, toute version comprise entre1.2.0et1.2.xest considérée comme valide. L’option--forcepeut ê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
Windows developer