Skip to content

Commit ed64cca

Browse files
committed
Acrolinx fixes
1 parent 25ba0b7 commit ed64cca

File tree

1 file changed

+13
-13
lines changed

1 file changed

+13
-13
lines changed

docs/install/automated-installation-with-response-file.md

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Configure installation defaults with a response file
33
description: Create a response JSON file to help automate your Visual Studio installation with default settings for workloads, components, and other installation options.
4-
ms.date: 10/25/2024
4+
ms.date: 10/28/2024
55
ms.topic: conceptual
66
helpviewer_keywords:
77
- response file
@@ -16,7 +16,7 @@ ms.subservice: installation
1616
---
1717
# Configure installation default settings using a response file
1818

19-
In this article, you'll learn how to create a response file that helps you automate your Visual Studio installation. It's most commonly used when you install Visual Studio from a [layout](create-a-network-installation-of-visual-studio.md).
19+
In this article, you learn how to create a response file that helps you automate your Visual Studio installation. It's most common use is when you install Visual Studio from a [layout](create-a-network-installation-of-visual-studio.md).
2020

2121
The Visual Studio response file is a [JSON](http://json-schema.org/) file whose contents contain customizations used during the initial installation of Visual Studio onto the client. Its contents mirror the [command line arguments and parameters](use-command-line-parameters-to-install-visual-studio.md). Use the response file for the following configuration options:
2222

@@ -27,11 +27,11 @@ The Visual Studio response file is a [JSON](http://json-schema.org/) file whose
2727

2828
## Creating the response file
2929

30-
The `response.json` file is typically created when an administrator [creates a layout](create-a-network-installation-of-visual-studio.md) and can be found in the root folder of the layout. However, you can create your own response file using one of the examples below.
30+
The `response.json` file is typically created when an administrator [creates a layout](create-a-network-installation-of-visual-studio.md) and can be found in the root folder of the layout. However, you can create your own response file using one of the following examples.
3131

3232
## Specifying the response file
3333

34-
If an administrator [deploys Visual Studio by invoking the bootstrapper from a layout](deploy-a-layout-onto-a-client-machine.md#install-visual-studio-onto-a-client-machine-from-a-layout), the response file found in the layout's root directory will automatically be used. Administrators can also choose to explicitly specify a different response file by using the `--in` parameter, as in the following example:
34+
If an administrator [deploys Visual Studio by invoking the bootstrapper from a layout](deploy-a-layout-onto-a-client-machine.md#install-visual-studio-onto-a-client-machine-from-a-layout), the response file found in the layout's root directory is automatically used. Administrators can also choose to explicitly specify a different response file by using the `--in` parameter, as in the following example:
3535

3636
```shell
3737
\\server\share\layoutdirectory\vs_enterprise.exe --in custom_response_file.json
@@ -48,15 +48,15 @@ Parameters that are specified on the command-line override the settings that are
4848

4949
## Configure the response file used when installing from a layout
5050

51-
If you created a layout by using the `--layout` command, then a default `response.json` file will be created in the root of the layout folder. Administrators are expected to modify and customize the response file appropriately *before* installing onto a client machine. That way, they can control the client's initial configuration settings.
51+
If you create a layout by using the `--layout` command, then a default `response.json` file is created in the root of the layout folder. Administrators are expected to modify and customize the response file appropriately *before* installing onto a client machine. That way, they can control the client's initial configuration settings.
5252

53-
The configuration settings in the `response.json` file are only referenced when executing a [bootstrapper](create-a-network-installation-of-visual-studio.md#download-the-visual-studio-bootstrapper-to-create-the-layout) (e.g. vs_enterprise.exe). Bootstrappers are typically used to perform initial installation on the client, but sometimes they're used to update a client too. The `response.json` is never used when you launch the installer locally on the client.
53+
The configuration settings in the `response.json` file are only referenced when executing a [bootstrapper](create-a-network-installation-of-visual-studio.md#download-the-visual-studio-bootstrapper-to-create-the-layout) (for example, vs_enterprise.exe). Bootstrappers are typically used to perform initial installation on the client, but sometimes they're used to update a client too. The `response.json` is never used when you launch the installer locally on the client.
5454

55-
If the administrator created a partial layout, then the default `response.json` file in the layout will specify only the workloads and languages that were included in the partial layout.
55+
If the administrator created a partial layout, then the default `response.json` file in the layout specifies only the workloads and languages that were included in the partial layout.
5656

57-
If the layout is created by passing in a `--config *.vsconfig` file, then the `*.vsconfig` file will be copied into the layout directory as `layout.vsconfig` and this config file will be referenced in the `response.json` file. This way, you can use configuration files to initialize client installations that come from a layout.
57+
If the layout is created by passing in a `--config *.vsconfig` file, then the `*.vsconfig` file is copied into the layout directory as `layout.vsconfig` and this config file is referenced in the `response.json` file. This way, you can use configuration files to initialize client installations that come from a layout.
5858

59-
Make sure to pay special attention to the channelUri setting, which configures [where the client will look for updates](update-visual-studio.md#configure-source-location-of-updates-1). The default configuration is for the client to look at Microsoft hosted servers on the internet for updates. You'll need to change the value of channelUri and point it to your layout if you want clients to get their updates from your layout. Examples for how to do this are [detailed below](#example-customized-layout-response-file-content). You can always change where a client looks for updates in the future by [executing the installer on the client and invoking the `modifySettings` command](use-command-line-parameters-to-install-visual-studio.md#modifysettings-command-and-command-line-parameters).
59+
Make sure to pay special attention to the channelUri setting, which configures [where the client looks for updates](update-visual-studio.md#configure-source-location-of-updates-1). The default configuration is for the client to look at Microsoft hosted servers on the internet for updates. You need to change the value of channelUri and point it to your layout if you want clients to get their updates from your layout. Examples for how to do this are [detailed below](#example-customized-layout-response-file-content). You can always change where a client looks for updates in the future by [executing the installer on the client and invoking the `modifySettings` command](use-command-line-parameters-to-install-visual-studio.md#modifysettings-command-and-command-line-parameters).
6060

6161
If the client installation is **not** done using `--quiet` or `--passive` mode, users can override the defaults specified in the `response.json` and further select or unselect additional workloads and components to install.
6262

@@ -103,13 +103,13 @@ The base `response.json` file in a layout should look similar to the following e
103103

104104
::: moniker-end
105105

106-
When you create or update a layout, a response.template.json file is also created. This file contains all of the workload, component, and language IDs that can be used. This file is provided as a template for what all could be included in a custom install. Administrators can use this file as a starting point for a custom response file. Just remove the IDs for the things you do not want to install and save it in the `response.json` file or your own response file. Do not customize the response.template.json file or your changes will be lost whenever the layout is updated.
106+
When you create or update a layout, a response.template.json file is also created. This file contains all of the workload, component, and language IDs that can be used. This file is provided as a template for what all could be included in a custom install. Administrators can use this file as a starting point for a custom response file. Just remove the IDs for the things you do not want to install and save it in the `response.json` file or your own response file. Do not customize the response.template.json file or your changes are lost whenever the layout is updated.
107107

108108
## Example customized layout response file content
109109

110110
::: moniker range="=vs-2019"
111111

112-
The following `response.json` file example will initialize a Visual Studio Enterprise client install to select several common workloads and components, to select both the English and French UI languages, and to have the update location configured to look for sources in a network hosted layout. Note that for Visual Studio 2019, the update location (channelUri) can only be configured during initial installation and cannot be changed after the fact *unless* you use the functionality in the latest installer. Refer to the [Configure policies for enterprise deployments of Visual Studio](configure-policies-for-enterprise-deployments.md#configuring-source-location-for-updates) and the [Configure your layout to always include and provide the latest installer](create-a-network-installation-of-visual-studio.md#configure-the-layout-to-always-include-and-provide-the-latest-installer) for information on how to configure this.
112+
The following `response.json` file example initializes a Visual Studio Enterprise client install to select several common workloads and components, to select both the English and French UI languages, and to have the update location configured to look for sources in a network hosted layout. For Visual Studio 2019, the update location (channelUri) can only be configured during initial installation and cannot be changed after the fact *unless* you use the functionality in the latest installer. Refer to the [Configure policies for enterprise deployments of Visual Studio](configure-policies-for-enterprise-deployments.md#configuring-source-location-for-updates) and the [Configure your layout to always include and provide the latest installer](create-a-network-installation-of-visual-studio.md#configure-the-layout-to-always-include-and-provide-the-latest-installer) for information on how to configure this.
113113

114114
```Example response.json
115115
{
@@ -147,7 +147,7 @@ The following `response.json` file example will initialize a Visual Studio Enter
147147

148148
::: moniker range="=vs-2022"
149149

150-
The following `response.json` file example will initialize a Visual Studio Enterprise client install to select several common workloads and components, to select both the English and French UI languages, and to have the update location configured to look for sources in a network hosted layout. Refer to the [Configure policies for enterprise deployments of Visual Studio](configure-policies-for-enterprise-deployments.md#configuring-source-location-for-updates) and the [Configure your layout to always include and provide the latest installer](create-a-network-installation-of-visual-studio.md#configure-the-layout-to-always-include-and-provide-the-latest-installer) for information on how to configure this.
150+
The following `response.json` file example initializes a Visual Studio Enterprise client install to select several common workloads and components, to select both the English and French UI languages, and to have the update location configured to look for sources in a network hosted layout. Refer to the [Configure policies for enterprise deployments of Visual Studio](configure-policies-for-enterprise-deployments.md#configuring-source-location-for-updates) and the [Configure your layout to always include and provide the latest installer](create-a-network-installation-of-visual-studio.md#configure-the-layout-to-always-include-and-provide-the-latest-installer) for information on how to configure this.
151151

152152
```Example response.json
153153
{
@@ -187,7 +187,7 @@ In the following example, the `response.json` file initializes a Visual Studio E
187187
- Selects both the English and French UI languages
188188
- Configures the [update location to look for sources in an http hosted layout](create-a-network-installation-of-visual-studio.md#making-your-layout-accessible-via-an-intranet-site)
189189
- Allows [programmatic loading of unsigned extensions](import-export-installation-configurations.md#extensions)
190-
- [Removes components that have transitioned to an out-of-support state at the time of updating the client](update-visual-studio.md#remove-out-of-support-components). See the list of out-of-support components [here](out-of-support-components.md).
190+
- [Removes components transitioned to an out-of-support state at the time of updating the client](update-visual-studio.md#remove-out-of-support-components). See the list of out-of-support components [here](out-of-support-components.md).
191191

192192
```Example response.json
193193
{

0 commit comments

Comments
 (0)