Commande source winget

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 :

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é.
--disable-interactivity	Désactivez les invites interactives.

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] <name> [-a, --arg] <url> [[-t, --type] <type>]

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
--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.
-?, --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é.
--disable-interactivity	Désactivez les invites interactives.

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

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é.
--disable-interactivity	Désactivez les invites interactives.

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

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é.
--disable-interactivity	Désactivez les invites interactives.

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

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é.
--disable-interactivity	Désactivez les invites interactives.

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

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é.
--disable-interactivity	Désactivez les invites interactives.

export

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

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é.
--disable-interactivity	Désactivez les invites interactives.

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.

Rubriques connexes

• Utiliser l’outil winget pour installer et gérer des applications