settings, commande (winget)

  • Article

La commande settings de l’outil winget vous permet de personnaliser votre expérience du client Gestionnaire de package Windows. Vous pouvez modifier les valeurs par défaut et essayer les fonctionnalités expérimentales qui sont activées dans votre client.

La commande settings lance votre éditeur de texte par défaut. Par défaut, Windows lance le Bloc-notes. Nous vous recommandons d’utiliser un outil comme Visual Studio Code.

Notes

Vous pouvez facilement installer Visual Studio Code en tapantwinget install Microsoft.VisualStudioCode

Alias

Les alias suivants sont disponibles pour cette commande :

  • config

Utiliser la commande winget settings

Lancez votre outil d’édition JSON par défaut : winget settings

Quand vous lancez l’édition des paramètres pour la première fois, aucun paramètre n’est spécifié. En haut du fichier JSON, nous fournissons un lien où vous pouvez découvrir les fonctionnalités et les paramètres expérimentaux les plus récents.

L’extrait de code ci-dessous est un exemple de ce que à quoi votre fichier de paramètres doit ressembler si vous voulez activer ou modifier certaines de ces fonctionnalités et paramètres expérimentaux.

{
    "$schema": "https://aka.ms/winget-settings.schema.json",

    // For documentation on these settings, see: https://aka.ms/winget-settings
    "experimentalFeatures": {
	  "dependencies": true,
	  "directMSI": false,
	  "zipInstall": false,
    },
    "visual": {
        "progressBar": "rainbow"
    },
    "source": {
        "autoUpdateIntervalInMinutes": 5
    },
}

Nous avons également défini un schéma pour le fichier des paramètres. Ceci vous permet d’utiliser la touche Tab pour découvrir les paramètres et la syntaxe si votre éditeur JSON prend en charge les schémas JSON.

Notes

Les fonctionnalités expérimentales sont disponibles seulement dans les builds en préversion. Vous trouverez des instructions pour obtenir une build en préversion dans le dépôt GitHub.

Mise à jour des paramètres

Les paramètres suivants sont disponibles pour la version 1.0 du Gestionnaire de package Windows.

Paramètres source

Les paramètres source impliquent la configuration de la source WinGet.

"source": {
    "autoUpdateIntervalInMinutes": 3
},

autoUpdateIntervalInMinutes

Un entier positif représente l’intervalle de mise à jour en minutes. La recherche des mises à jour se produit seulement quand une source est utilisée. La valeur zéro désactive la recherche des mises à jour d’une source. Les autres valeurs ne sont pas valides.

  • Désactiver : 0
  • Valeur par défaut : 5

Pour mettre à jour manuellement la source, utilisez winget source update.

Paramètres visual

Les paramètres visual impliquent des éléments visuels affichés par WinGet

"visual": {
    "progressBar": "accent"
},

progressBar

Couleur de la barre de progression affichée par WinGet quand elle n’est pas spécifiée par des arguments.

  • accent (par défaut)
  • retro
  • rainbow

Paramètres installBehavior

Les paramètres installBehavior affectent le comportement par défaut de l’installation et de la mise à niveau (le cas échéant) des packages .

disableInstallNotes

Le comportement de disableInstallNotes affecte l’affichage des notes d’installation après une installation réussie. Prend la valeur par défaut false si la valeur n’est pas définie ou n’est pas valide.

    "installBehavior": {
        "disableInstallNotes": true
    },

Paramètre portablePackageUserRoot

Le paramètre portablePackageUserRoot affecte le répertoire racine par défaut où les packages sont installés sous l’étendue User. Ce paramètre s’applique seulement aux packages avec le type de programme d’installation portable. Prend la valeur par défaut %LOCALAPPDATA%/Microsoft/WinGet/Packages/ si la valeur n’est pas définie ou n’est pas valide.

Remarque : La valeur de ce paramètre doit être un chemin absolu.

    "installBehavior": {
        "portablePackageUserRoot": "C:/Users/FooBar/Packages"
    },

Paramètre portablePackageMachineRoot

Le paramètre portablePackageMachineRoot affecte le répertoire racine par défaut où les packages sont installés sous l’étendue Machine. Ce paramètre s’applique seulement aux packages avec le type de programme d’installation portable. Prend la valeur par défaut %PROGRAMFILES%/WinGet/Packages/ si la valeur n’est pas définie ou n’est pas valide.

Remarque : La valeur de ce paramètre doit être un chemin absolu.

    "installBehavior": {
        "portablePackageMachineRoot": "C:/Program Files/Packages/Portable"
    },

Paramètres preferences et requirements

Certains paramètres sont dupliqués sous preferences et requirements.

  • Le paramètre preferences affecte la façon dont les différentes options disponibles sont triées quand vous choisissez celle sur laquelle vous voulez agir. Par exemple, l’étendue par défaut des installations des packages est pour l’utilisateur actif, mais si ce n’est pas une option, un programme d’installation au niveau de la machine sera choisi.
  • Le paramètre requirements filtre les options, ce qui peut entraîner une liste vide et un échec d’installation. Dans l’exemple précédent, l’exigence d’une étendue utilisateur ferait qu’aucun programme d’installation ne serait applicable et entraînerait une erreur.

Les arguments passés sur la ligne de commande vont remplacer le paramètre requirement correspondant pour la durée d’exécution de cette commande.

scope

Le comportement de scope affecte le choix entre l’installation d’un package pour l’utilisateur actif et pour toute la machine. Le paramètre correspondant est --scope, et il utilise les mêmes valeurs (user ou machine). Consultez Problèmes connus liés à l’étendue de l’installation du package.

"installBehavior": {
    "preferences": {
        "scope": "user"
    }
},

locale

Le comportement de locale affecte le choix du programme d’installation en fonction des paramètres régionaux de celui-ci. Le paramètre correspondant est --locale et il utilise l’étiquette de langue bcp47.

"installBehavior": {
    "preferences": {
        "locale": [ "en-US", "fr-FR" ]
    }
},

architectures

Le comportement de architectures affecte les architectures qui seront sélectionnées lors de l’installation d’un package. Le paramètre correspondant est --architecture. Notez que seules les architectures compatibles avec votre système peuvent être sélectionnées.

    "installBehavior": {
        "preferences": {
            "architectures": ["x64", "arm64"]
        }
    },

installerTypes

Le comportement installerTypes affecte les types de programme d’installation qui seront sélectionnées lors de l’installation d’un package. Le paramètre correspondant est --installer-type.

    "installBehavior": {
        "preferences": {
            "installerTypes": ["msix", "msi"]
        }
    },

uninstallBehavior

Les paramètres uninstallBehavior affectent le comportement par défaut de la désinstallation des packages (si applicable).

purgePortablePackage

Le comportement de purgePortablePackage affecte le comportement par défaut de la désinstallation d’un package portable. S’il est défini sur true, la désinstallation va supprimer tous les fichiers et répertoires relatifs au package portable. Ce paramètre s’applique seulement aux packages avec le type de programme d’installation portable. Prend la valeur par défaut false si la valeur n’est pas définie ou n’est pas valide.

    "uninstallBehavior": {
        "purgePortablePackage": true
    },

downloadBehavior

Les paramètres downloadBehavior affectent le comportement par défaut du téléchargement des packages.

defaultDownloadDirectory

Le paramètre defaultDownloadDirectory affecte le répertoire par défaut dans lequel les packages sont téléchargés. Prend la valeur par défaut %USERPROFILE%/Downloads si la valeur n’est pas définie ou n’est pas valide.

Remarque : La valeur de ce paramètre doit être un chemin absolu.

    "downloadBehavior": {
        "defaultDownloadDirectory": "C:/Users/FooBar/Downloads"
    },

Paramètres telemetry

Les paramètres telemetry contrôlent si winget écrit des événements ETW qui peuvent être envoyés à Microsoft sur une installation par défaut de Windows.

Consultez Détails sur la télémétrie et notre Déclaration de confidentialité principale.

disable

"telemetry": {
    "disable": true
},

Si la valeur est true, le paramètre telemetry.disable empêche l’écriture d’événements par le programme.

Paramètres network

Les paramètres network influencent la façon dont winget utilise le réseau pour récupérer les packages et les métadonnées.

downloader

Le paramètre downloader contrôle le code qui est utilisé lors du téléchargement de packages. La valeur par défaut est default, qui peut être une des options en fonction de ce que nous déterminons.

wininet utilise les API WinINet, tandis que do utilise le service Optimisation de la distribution.

"network": {
    "downloader": "do"
}

Paramètres logging

Les paramètres logging contrôlent le niveau de détail dans les fichiers journaux. --verbose-logs remplace ce paramètre et crée toujours un journal détaillé.

"logging": {
    "level": "verbose"
}

level

Les niveaux de journalisation suivants sont disponibles. Prend la valeur par défaut info si la valeur n’est pas définie ou n’est pas valide.

  • verbose
  • info
  • warning
  • error
  • Critique

Activation des fonctionnalités expérimentales

Pour découvrir les fonctionnalités expérimentales disponibles, accédez à https://aka.ms/winget-settings, où vous pouvez voir les fonctionnalités expérimentales disponibles.