From 64e1f1d19629d2a415c669512eec3bb43bc7350b Mon Sep 17 00:00:00 2001 From: Megha Anand <88059806+anandmeg@users.noreply.github.com> Date: Wed, 26 Jul 2023 15:05:15 -0700 Subject: [PATCH 1/8] Add vsconfig examples --- ...mport-export-installation-configurations.md | 18 ++++++++++++++++-- docs/install/using-visual-studio-vm.md | 2 +- 2 files changed, 17 insertions(+), 3 deletions(-) diff --git a/docs/install/import-export-installation-configurations.md b/docs/install/import-export-installation-configurations.md index 5a505223ae0..40d3c890171 100644 --- a/docs/install/import-export-installation-configurations.md +++ b/docs/install/import-export-installation-configurations.md @@ -2,7 +2,7 @@ title: Import or export installation configurations titleSuffix: '' description: Learn how to export your installation configuration to a .vsconfig file to share with others, and how to import it to clone. -ms.date: 2/21/2023 +ms.date: 7/27/2023 ms.topic: how-to helpviewer_keywords: - import installation configuration @@ -59,12 +59,26 @@ When you're ready to import an installation configuration file, follow these ste ## Use a configuration file to initialize the contents of a layout -Using the correct bootstrapper that corresponds to the version and edition of Visual Studio that you want, open an administrator command prompt and run the following command. +Using the correct bootstrapper that corresponds to the version and edition of Visual Studio that you want, open an administrator command prompt and run the following command to use --config to configure the contents of a layout: ```shell vs_enterprise.exe --layout c:\localVSlayout --config c:\myconfig.vsconfig --lang en-US ``` +* Use --config to install the workloads and components from a previously saved installation configuration file: + + ```shell + vs_enterprise.exe --config "C:\myconfig.vsconfig" --installPath "C:\VS" + ``` + +* Use --config to add workloads and components to an existing installation. This example uses the installer already on the client machine. + + ```shell + "C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modify --installPath "C:\VS" --config "C:\myconfig.vsconfig" + ``` + +When you install Visual Studio programmatically or by using a command prompt, you can use various command-line parameters to control or customize the installation. To learn more, see [Install Visual Studio from the command line](use-command-line-parameters-to-install-visual-studio.md). + ## Automatically install missing components Save a .vsconfig file to your solution root directory and then open a solution. Visual Studio automatically detects the missing components and prompts you to install them. diff --git a/docs/install/using-visual-studio-vm.md b/docs/install/using-visual-studio-vm.md index 4e090d3c27e..7525ae6238d 100644 --- a/docs/install/using-visual-studio-vm.md +++ b/docs/install/using-visual-studio-vm.md @@ -2,7 +2,7 @@ title: Using Visual Studio on an Azure Virtual Machine titleSuffix: '' description: Learn how to use Visual Studio on an Azure Virtual Machine -ms.date: 07/23/2022 +ms.date: 07/26/2023 ms.topic: conceptual helpviewer_keywords: - azure services From 4436c66bb5d195d9908e9a3ed43fc8d283e3d0df Mon Sep 17 00:00:00 2001 From: Megha Anand <88059806+anandmeg@users.noreply.github.com> Date: Wed, 26 Jul 2023 16:17:44 -0700 Subject: [PATCH 2/8] fix bullets --- docs/install/import-export-installation-configurations.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/install/import-export-installation-configurations.md b/docs/install/import-export-installation-configurations.md index 40d3c890171..e471063285f 100644 --- a/docs/install/import-export-installation-configurations.md +++ b/docs/install/import-export-installation-configurations.md @@ -65,13 +65,13 @@ Using the correct bootstrapper that corresponds to the version and edition of Vi vs_enterprise.exe --layout c:\localVSlayout --config c:\myconfig.vsconfig --lang en-US ``` -* Use --config to install the workloads and components from a previously saved installation configuration file: +Use --config to install the workloads and components from a previously saved installation configuration file: ```shell vs_enterprise.exe --config "C:\myconfig.vsconfig" --installPath "C:\VS" ``` -* Use --config to add workloads and components to an existing installation. This example uses the installer already on the client machine. +Use --config to add workloads and components to an existing installation. This example uses the installer already on the client machine. ```shell "C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modify --installPath "C:\VS" --config "C:\myconfig.vsconfig" From 06ef9daeadb28f72f2559da90209069d3d3449de Mon Sep 17 00:00:00 2001 From: Megha Anand <88059806+anandmeg@users.noreply.github.com> Date: Wed, 26 Jul 2023 16:19:46 -0700 Subject: [PATCH 3/8] Updates --- docs/install/import-export-installation-configurations.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/install/import-export-installation-configurations.md b/docs/install/import-export-installation-configurations.md index e471063285f..ce0602b4fab 100644 --- a/docs/install/import-export-installation-configurations.md +++ b/docs/install/import-export-installation-configurations.md @@ -65,13 +65,15 @@ Using the correct bootstrapper that corresponds to the version and edition of Vi vs_enterprise.exe --layout c:\localVSlayout --config c:\myconfig.vsconfig --lang en-US ``` -Use --config to install the workloads and components from a previously saved installation configuration file: +Some other examples of using --config: + +* Use --config to install the workloads and components from a previously saved installation configuration file: ```shell vs_enterprise.exe --config "C:\myconfig.vsconfig" --installPath "C:\VS" ``` -Use --config to add workloads and components to an existing installation. This example uses the installer already on the client machine. +* Use --config to add workloads and components to an existing installation. This example uses the installer already on the client machine. ```shell "C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modify --installPath "C:\VS" --config "C:\myconfig.vsconfig" From 7bcfdf04cf2f52ff50630b5f217b3248c9422590 Mon Sep 17 00:00:00 2001 From: Megha Anand <88059806+anandmeg@users.noreply.github.com> Date: Thu, 27 Jul 2023 22:55:53 -0700 Subject: [PATCH 4/8] updates per feedback --- ...port-export-installation-configurations.md | 28 ++++++++----------- docs/install/modify-visual-studio.md | 4 ++- 2 files changed, 14 insertions(+), 18 deletions(-) diff --git a/docs/install/import-export-installation-configurations.md b/docs/install/import-export-installation-configurations.md index ce0602b4fab..abafc79d51b 100644 --- a/docs/install/import-export-installation-configurations.md +++ b/docs/install/import-export-installation-configurations.md @@ -2,7 +2,7 @@ title: Import or export installation configurations titleSuffix: '' description: Learn how to export your installation configuration to a .vsconfig file to share with others, and how to import it to clone. -ms.date: 7/27/2023 +ms.date: 7/28/2023 ms.topic: how-to helpviewer_keywords: - import installation configuration @@ -57,29 +57,23 @@ When you're ready to import an installation configuration file, follow these ste 1. Make sure you've got the workloads and components that you want, and then choose **Close**. -## Use a configuration file to initialize the contents of a layout - -Using the correct bootstrapper that corresponds to the version and edition of Visual Studio that you want, open an administrator command prompt and run the following command to use --config to configure the contents of a layout: +## Use a configuration file to add components to an existing installation + +Use `--config` to modify an existing installation to add or remove components. This example uses the installer already on the client machine. ```shell -vs_enterprise.exe --layout c:\localVSlayout --config c:\myconfig.vsconfig --lang en-US +"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modify --installPath "C:\VS" --config "C:\myconfig.vsconfig" ``` -Some other examples of using --config: - -* Use --config to install the workloads and components from a previously saved installation configuration file: - - ```shell - vs_enterprise.exe --config "C:\myconfig.vsconfig" --installPath "C:\VS" - ``` +When you install Visual Studio programmatically or by using a command prompt, you can use various command-line parameters to control or customize the installation. To learn more, see [Install Visual Studio from the command line](use-command-line-parameters-to-install-visual-studio.md). -* Use --config to add workloads and components to an existing installation. This example uses the installer already on the client machine. +## Use a configuration file to initialize the contents of a layout - ```shell - "C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modify --installPath "C:\VS" --config "C:\myconfig.vsconfig" - ``` +Using the correct bootstrapper that corresponds to the version and edition of Visual Studio that you want, open an administrator command prompt and run the following command to use `-config` to configure the contents of a layout: -When you install Visual Studio programmatically or by using a command prompt, you can use various command-line parameters to control or customize the installation. To learn more, see [Install Visual Studio from the command line](use-command-line-parameters-to-install-visual-studio.md). +```shell +vs_enterprise.exe --layout c:\localVSlayout --config c:\myconfig.vsconfig --lang en-US +``` ## Automatically install missing components diff --git a/docs/install/modify-visual-studio.md b/docs/install/modify-visual-studio.md index e39e856b6ce..ad57a280a47 100644 --- a/docs/install/modify-visual-studio.md +++ b/docs/install/modify-visual-studio.md @@ -2,7 +2,7 @@ title: "Modify Visual Studio workloads, components, & language packs" titleSuffix: '' description: Learn how to modify Visual Studio, step-by-step. -ms.date: 5/16/2023 +ms.date: 7/28/2023 ms.topic: how-to ms.custom: vs-acquisition helpviewer_keywords: @@ -133,6 +133,8 @@ Workloads contain the components you need for the programming language or platfo 1. After the modified workloads or components are installed, choose **Launch** from the Visual Studio Installer to open Visual Studio 2022. +You can also use a [configuration file to modify an existing installation to add or remove components](import-export-installation-configurations.md#use-a-configuration-file-to-add-components-to-an-existing-installation). Learn more about using [installation configuration files to configure Visual Studio](import-export-installation-configurations.md). + ::: moniker-end > [!TIP] From 5dfbb7cf539dd00775ce3be09ebf40baf796deeb Mon Sep 17 00:00:00 2001 From: Megha Anand <88059806+anandmeg@users.noreply.github.com> Date: Thu, 27 Jul 2023 23:13:30 -0700 Subject: [PATCH 5/8] Fixes --- docs/install/import-export-installation-configurations.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/docs/install/import-export-installation-configurations.md b/docs/install/import-export-installation-configurations.md index abafc79d51b..41508ef3632 100644 --- a/docs/install/import-export-installation-configurations.md +++ b/docs/install/import-export-installation-configurations.md @@ -65,6 +65,9 @@ Use `--config` to modify an existing installation to add or remove components. T "C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modify --installPath "C:\VS" --config "C:\myconfig.vsconfig" ``` +> [!NOTE] +> To add or remove components to an existing installation by using a config file (*.vsconfig), you'll need to **modify** your installed product and not update. Update just updates the components and not add or remove new ones. + When you install Visual Studio programmatically or by using a command prompt, you can use various command-line parameters to control or customize the installation. To learn more, see [Install Visual Studio from the command line](use-command-line-parameters-to-install-visual-studio.md). ## Use a configuration file to initialize the contents of a layout From 9344ee614c5b27ffa5304376b25748f5ac203823 Mon Sep 17 00:00:00 2001 From: Megha Anand <88059806+anandmeg@users.noreply.github.com> Date: Thu, 27 Jul 2023 23:23:05 -0700 Subject: [PATCH 6/8] Fixes --- docs/install/import-export-installation-configurations.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/install/import-export-installation-configurations.md b/docs/install/import-export-installation-configurations.md index 41508ef3632..e8b78da826c 100644 --- a/docs/install/import-export-installation-configurations.md +++ b/docs/install/import-export-installation-configurations.md @@ -66,7 +66,7 @@ Use `--config` to modify an existing installation to add or remove components. T ``` > [!NOTE] -> To add or remove components to an existing installation by using a config file (*.vsconfig), you'll need to **modify** your installed product and not update. Update just updates the components and not add or remove new ones. +> To add or remove components to an existing installation by using a config file (*.vsconfig), you'll need to **modify** your installed product and not update. Update just updates the components, not add or remove new ones. When you install Visual Studio programmatically or by using a command prompt, you can use various command-line parameters to control or customize the installation. To learn more, see [Install Visual Studio from the command line](use-command-line-parameters-to-install-visual-studio.md). From 352d24e3729fd818658d39848a396e89e1a14389 Mon Sep 17 00:00:00 2001 From: Megha Anand <88059806+anandmeg@users.noreply.github.com> Date: Thu, 27 Jul 2023 23:25:19 -0700 Subject: [PATCH 7/8] Fixes --- docs/install/import-export-installation-configurations.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/install/import-export-installation-configurations.md b/docs/install/import-export-installation-configurations.md index e8b78da826c..8194cc189fc 100644 --- a/docs/install/import-export-installation-configurations.md +++ b/docs/install/import-export-installation-configurations.md @@ -66,7 +66,7 @@ Use `--config` to modify an existing installation to add or remove components. T ``` > [!NOTE] -> To add or remove components to an existing installation by using a config file (*.vsconfig), you'll need to **modify** your installed product and not update. Update just updates the components, not add or remove new ones. +> To add or remove components to an existing installation by using a config file (*.vsconfig), you'll need to **modify** your installed product and not update. **Update** just updates the components, doesn't add or remove new ones. When you install Visual Studio programmatically or by using a command prompt, you can use various command-line parameters to control or customize the installation. To learn more, see [Install Visual Studio from the command line](use-command-line-parameters-to-install-visual-studio.md). From 9cba96411f0b1f50a75b1f4f60fd83f5abf82c3d Mon Sep 17 00:00:00 2001 From: Megha Anand <88059806+anandmeg@users.noreply.github.com> Date: Fri, 28 Jul 2023 12:50:08 -0700 Subject: [PATCH 8/8] Make suggested change --- docs/install/import-export-installation-configurations.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/install/import-export-installation-configurations.md b/docs/install/import-export-installation-configurations.md index 8194cc189fc..293684f45fa 100644 --- a/docs/install/import-export-installation-configurations.md +++ b/docs/install/import-export-installation-configurations.md @@ -66,7 +66,7 @@ Use `--config` to modify an existing installation to add or remove components. T ``` > [!NOTE] -> To add or remove components to an existing installation by using a config file (*.vsconfig), you'll need to **modify** your installed product and not update. **Update** just updates the components, doesn't add or remove new ones. +> To add or remove components to an existing installation by using a config file (*.vsconfig), you'll need to **modify** your installed product and not update. **Update** just updates the components to the latest version; it doesn't add or remove new ones. When you install Visual Studio programmatically or by using a command prompt, you can use various command-line parameters to control or customize the installation. To learn more, see [Install Visual Studio from the command line](use-command-line-parameters-to-install-visual-studio.md).