Merge pull request #4470 from TerryGLee/tglee-install

[install] add "Import and export configurations" page

Author: ktoliver

docs/install/import-export-installation-configurations.md

@@ -0,0 +1,91 @@
+---
+title: "Import or export installation configurations"
+titleSuffix: ""
+description: "Learn how to use the import/export configuration feature in Visual Studio"
+ms.date: 04/15/2019
+ms.topic: conceptual
+f1_keywords:
+  - "vs.about"
+helpviewer_keywords:
+  - "import installation configuration"
+  - "export installation configuration"
+  - "install Visual Studio"
+  - "Visual Studio installer"
+author: TerryGLee
+ms.author: tglee
+manager: jillfra
+ms.workload:
+  - "multiple"
+ms.prod: visual-studio-windows
+ms.technology: vs-installation
+---
+# Import or export installation configurations
+
+You can configure Visual Studio across your organization by using an installation configuration file. To do so, simply export the workload and component information to a .vsconfig file by using the Visual Studio installer. You can then import the configuration into new or existing installations.
+
+Here's how.
+
+::: moniker range="vs-2017"
+
+> [!NOTE]
+> This functionality is available only in Visual Studio 2017 version 15.9 and later.
+
+::: moniker-end
+
+## Export a configuration
+
+You can choose to export an installation configuration file from either a previously installed instance of Visual Studio or one that you're currently installing.
+
+1. Open the Visual Studio Installer.
+
+1. On the product card, choose the **More** button, and then select **Export configuration**.
+
+1. Browse to or type the location where you want to save your .vconfig file, and then choose **Review details**.
+
+   ![Export configuration from the Visual Studio installer](../install/media/vs-2019/export-configuration-confirmation.png)
+
+1. Make sure you've got the workloads and components that you want, and then choose **Export**.
+
+## Import a configuration
+
+When you're ready to import an installation configuration file
+
+1. Open the Visual Studio Installer.
+
+1. On the product card, choose the **More** button, and then select **Import configuration**.
+
+1. Locate the .vconfig file that you want to import, and then choose **Review details**.
+
+1. Make sure you've got the workloads and components that you want, and then choose **Close**.
+
+::: moniker range="vs-2019"
+
+## Automatically install missing components
+
+**New in Visual Studio 2019**: When you save a .vsconfig file to your solution root directory and then open a solution, Visual Studio automatically detects which components are missing and prompts you to install them.
+
+![Solution Explorer suggests additional components](../install/media/vs-2019/solution-explorer-config-file.png)
+
+You can also generate a .vsconfig file right from Solution Explorer. Here's how.
+
+1. Right-click on your solution file.
+
+1. Choose **Add** > **Installation Configuration File**.
+
+1. Confirm the location where you want to save the .vsconfig file, and then choose **Review details**.
+
+1. Make sure you've got the workloads and components that you want, and then choose **Export**.
+
+::: moniker-end
+
+> [!NOTE]
+> For more information, see the [Configure Visual Studio across your organization with .vsconfig](https://devblogs.microsoft.com/setup/configure-visual-studio-across-your-organization-with-vsconfig/) blog post.
+
+[!INCLUDE[install_get_support_md](includes/install_get_support_md.md)]
+
+## See also
+
+* [Create a network installation of Visual Studio](create-a-network-installation-of-visual-studio.md)
+* [Update a networked-based installation of Visual Studio](update-a-network-installation-of-visual-studio.md)
+* [Control updates to Visual Studio deployments](controlling-updates-to-visual-studio-deployments.md)
+* [Set defaults for enterprise deployments](set-defaults-for-enterprise-deployments.md)

docs/install/media/vs-2019/config-file-recommend-install.png

@@ -60,6 +60,8 @@
         href: install/create-a-network-installation-of-visual-studio.md
       - name: Update a network-based installation of Visual Studio
         href: install/update-a-network-installation-of-visual-studio.md
+      - name: Import or export installation configurations
+        href: install/import-export-installation-configurations.md
       - name: Install and use Visual Studio behind a firewall or proxy server
         href: install/install-and-use-visual-studio-behind-a-firewall-or-proxy-server.md
         items: