Partager via

settings, commande (winget)

La commande paramètres de WinGet vous permet de personnaliser votre expérience cliente du Gestionnaire de package Windows. Vous pouvez modifier les valeurs par défaut et tester les fonctionnalités expérimentales disponibles dans votre client.

La commande paramètres lance votre éditeur JSON par défaut. Windows par défaut lance le Bloc-notes en tant qu’option. Nous vous recommandons d’utiliser un outil tel que Visual Studio Code.

Remarque

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

Alias

Les alias suivants sont disponibles pour cette commande :

  • config

Sous-commandes

Les sous-commandes suivantes sont disponibles.

Sous-commande Descriptif
export Exporte les paramètres.
set Définit la valeur d’un paramètre d’administrateur.
reset Réinitialise un paramètre d’administrateur à sa valeur par défaut.

Paramètres

Les options suivantes sont disponibles :

Raisonnement Descriptif
--enable Active le paramètre d’administrateur spécifié.
--désactiver Désactive le paramètre d’administrateur spécifié.
-?,--help Affiche de l’aide sur la commande sélectionnée.
--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,--verbose-logs Active la journalisation documentée pour l'outil de migration de l'état utilisateur (USMT).
--nowarn,--ignore-warnings Supprime les sorties d'avertissement.
--disable-interactivity Désactive les invites interactives.
--proxy Définit un proxy à utiliser pour cette exécution.
--no-proxy Désactive l’utilisation du proxy pour cette exécution.

Utiliser la commande paramètres winget

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

Lorsque vous lancez les paramètres pour la première fois, aucun paramètre n’est spécifié. En haut du fichier JSON, nous fournissons un lien Paramètres CLI WinGet , où vous pouvez découvrir les dernières fonctionnalités et paramètres expérimentaux.

L’extrait de code ci-dessous montre un exemple de ce que votre fichier de paramètres peut ressembler avec les modifications de sortie visuelle et les fonctionnalités expérimentales activées.

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

    "visual": {
        "enableSixels": true,
        "progressBar": "rainbow"
    },
    "experimentalFeatures": {
        "experimentalARG": true,
        "experimentalCMD": true
    }
}

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

Mise à jour des paramètres

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

paramètre source

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

"source": {
    "autoUpdateIntervalInMinutes": 60
},

autoUpdateIntervalInMinutes

Un entier positif représente l’intervalle de mise à jour en minutes. La vérification des mises à jour se produit uniquement lorsqu’une source est utilisée. Un zéro désactive la vérification des mises à jour d’une source. Toutes les autres valeurs ne sont pas valides.

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

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

paramètres visuels

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

"visual": {
    "enableSixels": true,
    "progressBar": "rainbow"
},

progressBar

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

  • accentuation (par défaut)
  • rainbow
  • Rétro
  • sixel
  • handicapé

anonymizeDisplayedPaths

Remplace certains chemins de dossiers connus par leurs variables d’environnement respectives.

enableSizels

Active la sortie d'images sixel dans certains contextes.

paramètres de journalisation

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

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

niveau

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

  • verbose
  • info
  • avertissement
  • erreur
  • Critique

préférences et paramètres de configuration requise

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

  • Le preferences paramètre contrôle la façon dont les différentes options disponibles sont triées lors du choix de celle sur laquelle agir. Par exemple, l’étendue par défaut des installations de package concerne l’utilisateur actuel, mais si ce n’est pas une option, un programme d’installation au niveau de l’ordinateur 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, une exigence d’étendue utilisateur entraînerait l'absence de programme d’installation applicable et une erreur.

Tous les arguments transmis sur la ligne de commande remplacent efficacement le paramètre de requirement correspondant pendant la durée de cette commande.

portée

Le scope comportement contrôle le choix entre l’installation d’un package pour l’utilisateur actuel ou pour l’ordinateur entier. Le paramètre correspondant est --scopeet 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"
    }
},

paramètres régionaux

Le comportement de locale régit le choix du programme d'installation en fonction des paramètres régionaux de celui-ci. Le paramètre correspondant est --localeet utilise la balise de langue bcp47.

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

architectures

Le architectures comportement contrôle les architectures sélectionnées lors de l’installation d’un package. Le paramètre correspondant est --architecture. Seules les architectures compatibles avec votre système peuvent être sélectionnées.

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

types d'installateur

Le installerTypes comportement contrôle les types d’installation sélectionnés lors de l’installation d’un package. Le paramètre correspondant est --installer-type.

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

Paramètres installBehavior

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

disableInstallNotes

Le disableInstallNotes paramètre détermine si les notes d’installation sont affichées après une installation réussie. La valeur par défaut est false si la valeur n’est pas définie ou n’est pas valide.

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

Paramètre portablePackageUserRoot

Le portablePackageUserRoot paramètre définit le répertoire racine par défaut pour l’installation de packages dans l’étendue User . Cela s’applique uniquement aux packages avec le type d’installation portable . La valeur par défaut est %LOCALAPPDATA%/Microsoft/WinGet/Packages/ si la valeur n’est pas définie ou n’est pas valide.

Cette valeur de paramètre doit être un chemin absolu.

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

Paramètre portablePackageMachineRoot

Le portablePackageMachineRoot paramètre définit le répertoire racine par défaut pour l’installation de packages dans l’étendue Machine . Cela s’applique uniquement aux packages avec le type d’installation portable . La valeur par défaut est %PROGRAMFILES%/WinGet/Packages/ si la valeur n’est pas définie ou n’est pas valide.

Cette valeur de paramètre doit être un chemin absolu.

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

defaultInstallRoot

Le defaultInstallRoot paramètre spécifie l’emplacement d’installation par défaut pour les packages qui nécessitent un chemin d’installation explicite, si l’emplacement d’installation n’est pas spécifié.

maxResumes

Le maxResumes paramètre spécifie le nombre maximal de tentatives de reprise autorisées pour un ID de reprise unique. Cela empêche les redémarrages continus si une installation nécessitant un redémarrage n’est pas correctement détectée.

méthode d'extraction d'archives

Le archiveExtractionMethod paramètre contrôle la façon dont le programme d’installation extrait les archives. Les valeurs prises en charge sont shellApi et tar.

  • shellApi utilise l’API Windows Shell pour extraire des archives.

  • tar utilise la commande tar pour extraire des archives.

Comportement de désinstallation

Le uninstallBehavior paramètre contrôle si le processus de désinstallation par défaut supprime tous les fichiers et répertoires pertinents pour ce package. S’applique uniquement au portable installerType.

purgePortablePackage

Le purgePortablePackage paramètre contrôle le comportement par défaut pour la désinstallation d’un package portable. Si la valeur est true, la désinstallation supprime tous les fichiers et répertoires pertinents pour le package portable. Ce paramètre s’applique uniquement aux packages avec le type de programme d’installation portable. La valeur par défaut est false si la valeur n’est pas définie ou n’est pas valide.

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

ConfigureBehavior

Le ConfigureBehavior paramètre spécifie le répertoire racine par défaut dans lequel les modules PowerShell sont installés lors de l’application d’une configuration.

comportement de téléchargement

Les downloadBehavior paramètres contrôlent le répertoire par défaut dans lequel les programmes d’installation sont téléchargés.

répertoireDeTéléchargementParDéfaut

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

Cette valeur de paramètre doit être un chemin absolu.

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

Paramètres de télémétrie

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

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

disable

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

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

Paramètres réseau

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

téléchargeur

Le paramètre downloader contrôle le code utilisé lors du téléchargement de packages. La valeur par défaut est do, qui peut être gérée par la stratégie de groupe.

utilise les API WinINet, tandis que utilise le service d’optimisation de la distribution .

"network": {
    "downloader": "wininet"
}

doProgressTimeoutInSeconds

Le doProgressTimeoutInSeconds spécifie le nombre de secondes à attendre sans progression avant le basculement.

Interactivité

Le Interactivity paramètre contrôle si les invites interactives sont affichées par le client Gestionnaire de package Windows.

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.

  • Last updated on