Partager via

Commande source winget

  • Article

La commande source de l’outil winget vous permet de gérer des sources pour le Gestionnaire de package Windows. Avec la commande source, vous pouvez ajouter, répertorier, mettre à jour, supprimer, réinitialiser ou exporter des référentiels.

Un référentiel source fournit les données dont vous avez besoin pour découvrir et installer des applications. Utilisez uniquement des emplacements sources sécurisés et approuvés.

Le Gestionnaire de package Windows spécifie les deux référentiels par défaut suivants, que vous pouvez répertorier à l’aide de winget source list.

  • msstore - Catalogue du Microsoft Store.
  • winget - Dépôt d’applications du Gestionnaire de package Windows.

Usage

winget source <subcommand> <options>

Arguments

Les arguments suivants sont disponibles.

Argument Description
-?, --help Fournit de l’aide supplémentaire sur cette commande.

L’image suivante montre l’aide pour la commande source :

Capture d’écran montrant l’aide de la commande source.

Options

Les options suivantes sont disponibles.

Option Description
-?,--help Affiche de l’aide sur la commande sélectionnée.
--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 source prend en charge les sous-commandes suivantes.

Sous-commande Description
add Ajoute une nouvelle source.
list Dresse la liste des sources activées.
update Met à jour une source.
remove Supprime une source.
reset Réinitialise winget et msstore à leur configuration initiale.
export Exporte les sources actuelles.

add

La sous-commande add ajoute une nouvelle source. Cette sous-commande nécessite les options --name et --arg. Dans la mesure où la commande change l’accès utilisateur, add nécessite des privilèges d’administrateur.

Utilisation :

winget source add [-n] <name> [-a] <arg> [[-t] <type>] [<options>]

Arguments

Les arguments suivants sont disponibles.

Argument Description
-n,--name Nom permettant d’identifier la source.
-a,--arg URL ou UNC de la source.
-t,--type Type de la source .

Options

Les options suivantes sont disponibles.

Option Description
--trust-level Niveau de confiance de la source (aucun ou confiance).
--header En-tête HTTP facultatif de la source REST du Gestionnaire de package Windows.
--accept-source-agreements Permet d’accepter le contrat de licence de la source et d’éviter l’invite.
--explicit
-?, --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.

Par exemple, winget source add --name Contoso https://www.contoso.com/cache ajoute le référentiel Contoso à l’URL https://www.contoso.com/cache.

Paramètre type facultatif

La sous-commande add prend en charge le paramètre type facultatif, qui indique au client le type de référentiel auquel il se connecte. Le type suivant est pris en charge.

Type Description
Microsoft.PreIndexed.Package Type de source par défaut.

list

La sous-commande list énumère les sources actuellement activées ou fournit des détails sur une source spécifique.

Utilisation :

winget source list [[-n] <name>] [<options>]

Alias

Les alias suivants sont disponibles pour cette sous-commande :

  • ls

Arguments

Les arguments suivants sont disponibles.

Argument Description
-n,--name Nom permettant d’identifier la source.

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.

list all

La sous-commande list utilisée seule, winget source list, affiche la liste complète des sources prises en charge :

Name   Arg
-----------------------------------------
winget https://winget.azureedge.net/cache

list source details

Pour obtenir des détails complets sur une source, transmettez le nom de la source. Par exemple :

winget source list --name Contoso

Retourne la sortie suivante :

Name   : Contoso
Type   : Microsoft.PreIndexed.Package
Arg    : https://pkgmgr-int.azureedge.net/cache
Data   : AppInstallerSQLiteIndex-int_g4ype1skzj3jy
Updated: 2020-4-14 17:45:32.000
  • Name est le nom de la source.
  • Type est le type de référentiel.
  • Arg est l’URL ou le chemin d’accès que la source utilise.
  • Data est le nom du package facultatif, le cas échéant.
  • Updated est la date et l’heure de la dernière mise à jour de la source.

update

La sous-commande update force la mise à jour vers une source individuelle ou toutes les sources.

Utilisation :

winget source update [[-n] <name>] [<options>]

Alias

Les alias suivants sont disponibles pour cette sous-commande :

  • actualiser

Arguments

Les arguments suivants sont disponibles.

Argument Description
-n,--name Nom permettant d’identifier la source.

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.

update all

La sous-commande de mise à jour utilisée seule, winget source update, demande des mises à jour de tous les référentiels.

source de mise à jour

La sous-commande de mise à jour avec l’option --name dirige une mise à jour vers la source nommée. Par exemple : winget source update --name Contoso force une mise à jour vers le référentiel Contoso.

remove

La sous-commande remove supprime une source. Avec cette sous-commande, l’option --name est obligatoire pour identifier la source. Dans la mesure où la commande change l’accès utilisateur, remove nécessite des privilèges d’administrateur.

Utilisation :

winget source remove [-n] <name> [<options>]

Alias

Les alias suivants sont disponibles pour cette sous-commande :

  • rm

Arguments

Les arguments suivants sont disponibles.

Argument Description
-n,--name Nom permettant d’identifier la source.

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.

Exemples

winget source remove --name Contoso

Cette commande supprime le référentiel Contoso.

reset

La sous-commande reset réinitialise le client à sa configuration d’origine et supprime toutes les sources à l’exception de la valeur par défaut. N’utilisez cette sous-commande que dans de rares cas. Dans la mesure où la commande change l’accès utilisateur, reset nécessite des privilèges d’administrateur.

Dans la mesure où la commande reset supprime toutes les sources, vous devez forcer l’action à utiliser l’option --force.

Utilisation :

winget source reset [[-n] <name>] [<options>]

Arguments

Les arguments suivants sont disponibles.

Argument Description
-n,--name Nom permettant d’identifier la source.

Options

Les options suivantes sont disponibles.

Option Description
--force Force la réinitialisation des sources.
-?, --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.

export

La sous-commande export vous permet d’exporter les détails spécifiques d’une source vers une sortie JSON.

Utilisation :

winget source export [[-n] <name>] [<options>]

Arguments

Les arguments suivants sont disponibles.

Argument Description
-n,--name Nom permettant d’identifier la source.

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.

Exemples

winget source export winget

Retourne la sortie suivante :

{"Arg":"https://winget.azureedge.net/cache","Data":"Microsoft.Winget.Source_8wekyb3d8bbwe","Identifier":"Microsoft.Winget.Source_8wekyb3d8bbwe","Name":"winget","Type":"Microsoft.PreIndexed.Package"}

Contrat source

Une source individuelle peut demander à l’utilisateur d’accepter les termes présentés avant d’ajouter ou d’utiliser le référentiel. Si un utilisateur n’accepte pas ou ne reconnaît pas le contrat, il ne pourra pas accéder à la source.

Vous pouvez utiliser l’option --accept-source-agreements pour accepter le contrat de licence source et éviter l’invite.

Capture d’écran montrant une invite de licence source.