Guide pratique pour définir des paramètres dans un fichier réponseHow to define settings in a response file

Les administrateurs qui déploient Visual Studio peuvent spécifier un fichier réponse à l’aide du paramètre --in, comme dans l’exemple suivant :Administrators who deploy Visual Studio can specify a response file by using the --in parameter, as in the following example:

vs_enterprise.exe --in customInstall.json

Les fichiers réponse sont des fichiers JSON dont le contenu reflète les arguments de la ligne de commande.Response files are JSON files whose contents mirror the command-line arguments. En général, si un paramètre de ligne de commande n’accepte aucun argument (par exemple, --quiet, --passive, etc.), la valeur dans le fichier réponse doit être true/false.In general, if a command-line parameter takes no arguments (for example, --quiet, --passive, etc.), the value in the response file should be true/false. S’il accepte un argument (par exemple, --installPath <dir>), la valeur dans le fichier réponse doit être une chaîne.If it takes an argument (for example, --installPath <dir>), the value in the response file should be a string. S’il accepte un argument et qu’il peut apparaître plusieurs fois sur la ligne de commande (par exemple, --add <id>), la valeur doit être un tableau de chaînes.If it takes an argument and can appear on the command line more than once (for example, --add <id>), it should be an array of strings.

Les paramètres spécifiés sur la ligne de commande remplacent les paramètres du fichier réponse, sauf si les paramètres acceptent plusieurs entrées (par exemple, --add).Parameters that are specified on the command-line override settings from the response file, except when parameters take multiple inputs (for example, --add). Lorsque vous avez plusieurs entrées, les entrées fournies sur la ligne de commande sont fusionnées avec les paramètres contenus dans le fichier réponse.When you have multiple inputs, the inputs supplied on the command line are merged with settings from the response file.

Définition d’une configuration par défaut pour Visual StudioSetting a default configuration for Visual Studio

Si vous avez créé un cache de disposition réseau avec --layout, un fichier response.json est créé dans la disposition.If you created a network layout cache with the --layout, an initial response.json file is created in the layout. Si vous créez une disposition partielle, ce fichier réponse inclut les charges de travail et les langues qui étaient englobées dans la disposition.If you create a partial layout, this response file includes the workloads and languages that were included in the layout. L’exécution du programme d’installation à partir de cette disposition utilise automatiquement ce fichier response.json qui sélectionne les charges de travail et les composants inclus dans la disposition.Running setup from this layout automatically uses this response.json file, which selects the workloads and components included in the layout. Les utilisateurs peuvent toujours sélectionner ou désélectionner toutes les charges de travail dans l’interface utilisateur du programme d’installation avant d’installer Visual Studio.Users can still select or unselect any workloads in the setup UI before installing Visual Studio.

Les administrateurs qui créent une disposition peuvent modifier le fichier response.json dans la disposition pour contrôler les paramètres par défaut que les utilisateurs voient lorsqu’ils installent Visual Studio à partir de cette disposition.Administrators who create a layout can modify the response.json file in the layout to control the default settings that their users see when they install Visual Studio from the layout. Par exemple, si un administrateur souhaite que des composants et des charges de travail spécifiques soient installés par défaut, il peut configurer le fichier response.json pour les ajouter.For example, if an administrator wants specific workloads and components installed by default, they can configure the response.json file to add them.

Quand le programme d’installation de Visual Studio est exécuté à partir d’un dossier de disposition, il utilise automatiquement le fichier réponse dans le dossier de disposition.When Visual Studio setup is run from a layout folder, it automatically uses the response file in the layout folder. Vous n’êtes pas obligé d’utiliser l’option --in.You don't have to use the --in option.

Vous pouvez mettre à jour le fichier response.json qui est créé dans un dossier de disposition en mode hors connexion, afin de définir les paramètres par défaut des utilisateurs qui procèdent à l’installation à partir de cette disposition.You can update the response.json file that is created in an offline layout folder to define the default setting for users who install from this layout.

Avertissement

Il est primordial de conserver les propriétés existantes qui ont été définies lors de la création de la disposition.It's critical that you leave the existing properties that were defined when the layout was created.

Le fichier response.json de base dans une disposition doit ressembler à l’exemple suivant, à ceci près qu’il doit inclure la valeur du produit et du canal que vous souhaitez installer :The base response.json file in a layout should look similar to the following example, except that it would include the value for the product and channel that you want to install:

{
  "installChannelUri": ".\\ChannelManifest.json",
  "channelUri": "https://aka.ms/vs/15/release/channel",
  "installCatalogUri": ".\\Catalog.json",
  "channelId": "VisualStudio.15.Release",
  "productId": "Microsoft.VisualStudio.Product.Enterprise"
}

Lorsque vous créez ou mettez à jour une disposition, un fichier response.template.json est également créé.When you create or update a layout, a response.template.json file is also created. Ce fichier contient tous les ID de charge de travail, de composant et de langue qu’il est possible d’utiliser.This file contains all of the workload, component, and language IDs that can be used. Ce fichier est fourni en tant que modèle pour tout ce qui peut être inclus dans une installation personnalisée.This file is provided as a template for what all could be included in a custom install. Les administrateurs peuvent utiliser ce fichier comme point de départ d’un fichier réponse personnalisé.Administrators can use this file as a starting point for a custom response file. Supprimez simplement les ID des éléments que vous ne souhaitez pas installer et enregistrez-le dans votre propre fichier réponse.Just remove the IDs for the things you do not want to install and save it in your own response file. Ne personnalisez pas le fichier response.template.json, sinon vos modifications sont perdues chaque fois que la disposition est mise à jour.Do not customize the response.template.json file or your changes will be lost whenever the layout is updated.

Exemple de contenu de fichier réponse dans la dispositionExample layout response file content

L’exemple suivant installe Visual Studio Enterprise avec six charges de travail et composants courants, ainsi que les langues d’interface utilisateur Anglais et Français.The following example installs Visual Studio Enterprise with six common workloads and components, and with both English and French UI languages. Vous pouvez utiliser cet exemple comme modèle ; il vous suffit de remplacer les charges de travail et les composants par ceux que vous voulez installer :You can use this example as a template; just change the workloads and components to those that you want to install:

{
  "installChannelUri": ".\\ChannelManifest.json",
  "channelUri": "https://aka.ms/vs/15/release/channel",
  "installCatalogUri": ".\\Catalog.json",
  "channelId": "VisualStudio.15.Release",
  "productId": "Microsoft.VisualStudio.Product.Enterprise",

  "installPath": "C:\\VS2017",
  "quiet": false,
  "passive": false,
  "includeRecommended": true,
  "norestart": false,

  "addProductLang": [
    "en-US",
    "fr-FR"
    ],

    "add": [
        "Microsoft.VisualStudio.Workload.ManagedDesktop",
        "Microsoft.VisualStudio.Workload.Data",
        "Microsoft.VisualStudio.Workload.NativeDesktop",
        "Microsoft.VisualStudio.Workload.NetWeb",
        "Microsoft.VisualStudio.Workload.Office",
        "Microsoft.VisualStudio.Workload.Universal",
        "Component.GitHub.VisualStudio"
    ]
}

Obtenir de l’aideGet support

Parfois, des problèmes peuvent se produire.Sometimes, things can go wrong. Si votre installation de Visual Studio échoue, consultez la page Résolution des problèmes d’installation et de mise à niveau de Visual Studio 2017.If your Visual Studio installation fails, see the Troubleshooting Visual Studio 2017 installation and upgrade issues page. Si aucune étape de résolution des problèmes ne vous aide, vous pouvez nous contacter pour une conversation en direct sur une assistance à l’installation (en anglais uniquement).If none of the troubleshooting steps help, you can contact us by live chat for installation assistance (English only). Pour plus de détails, consultez la page du support Visual Studio.For details, see the Visual Studio support page.

Voici d’autres options de support :Here are a few more support options:

Voir aussiSee also