You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
# Create an offline installation of Visual Studio 2017
23
-
24
-
If you are looking for an offline option for installing Visual Studio 2017, we can point you in the right direction.
25
-
26
-
* If you want to install a single instance of Visual Studio 2017 but your internet connection is unavailable or unreliable, see our [Install Visual Studio 2017 on low bandwidth or unreliable network environments](../install/install-vs-inconsistent-quality-network.md) page.
27
-
* If you are an enterprise administrator who wants to perform a large deployment of Visual Studio 2017 to a network of client workstations that are firewalled from the internet, see our [Create a network installation of Visual Studio 2017](../install/create-a-network-installation-of-visual-studio.md) and [Special considerations for installing Visual Studio in an offline environment](../install/install-visual-studio-in-offline-environment.md) pages.
Copy file name to clipboardExpand all lines: docs/install/create-a-network-installation-of-visual-studio.md
+37-37Lines changed: 37 additions & 37 deletions
Original file line number
Diff line number
Diff line change
@@ -1,7 +1,7 @@
1
1
---
2
2
title: "Create a network-based installation of Visual Studio | Microsoft Docs"
3
-
description: "{{PLACEHOLDER}}"
4
-
ms.date: "08/29/2017"
3
+
description: "Describes how to create a network install point for deploying Visual Studio within an enterprise"
4
+
ms.date: "08/30/2017"
5
5
ms.reviewer: ""
6
6
ms.suite: ""
7
7
ms.technology:
@@ -25,6 +25,7 @@ Commonly, an enterprise administrator creates a network install point for deploy
25
25
> If you have multiple editions of Visual Studio in use within your enterprise (for example, both Visual Studio Professional and Visual Studio Enterprise), you must create a separate network install share for each edition.
26
26
27
27
## Download the Visual Studio bootstrapper
28
+
28
29
**Download** the edition of Visual Studio you want. Make sure to click **Save**, and then click **Open folder**.
29
30
30
31
Your setup executable—or to be more specific, a bootstrapper file—should match one of the following.
@@ -38,29 +39,28 @@ Your setup executable—or to be more specific, a bootstrapper file—sh
38
39
Other supported bootstrappers include [vs_buildtools.exe](https://aka.ms/vs/15/release/vs_buildtools.exe), [vs_feedbackclient.exe](https://aka.ms/vs/15/release/vs_feedbackclient.exe), [vs_teamexplorer.exe](https://aka.ms/vs/15/release/vs_teamexplorer.exe), [vs_testagent.exe](https://aka.ms/vs/15/release/vs_testagent.exe), [vs_testcontroller.exe](https://aka.ms/vs/15/release/vs_testcontroller.exe), and [vs_testprofessional.exe](https://aka.ms/vs/15/release/vs_testprofessional.exe).
39
40
40
41
## Create an offline installation folder
42
+
41
43
To create an offline installation with all languages and all features, use one of the commands from the following examples:
42
44
43
45
(Make sure that you run the command from your Download directory. Typically, that's `C:\Users\<username>\Downloads` on a computer running Windows 10).
> A complete Visual Studio 2017 layout requires at least 20 GB of disk space and can take some time to download. See the [Customizing the network layout](#customizing-the-network-layout) section for details on how to create a layout with only the components you want to install.
62
61
63
62
## Modify the response.json file
63
+
64
64
You can modify the response.json to set default values that are used when setup is run. For example, you can configure the `response.json` file to select a specific set of workloads selected automatically.
65
65
See [Automate Visual Studio installation with a response file](automated-installation-with-response-file.md) for details.
66
66
@@ -71,48 +71,44 @@ Host the layout on a network share so it can be run from other machines.
There are several options you can use to customize your network layout. You can create a partial layout that only contains a specific set of [language locales](use-command-line-parameters-to-install-visual-studio.md#list-of-language-locales), [workloads, components, and their recommended or optional dependencies](workload-and-component-ids.md). This might be useful if you know that you are going to deploy only a subset of workloads to client workstations. Typical command-line parameters for customizing the layout include:
75
76
76
-
* ```--add``` to specify [workload or component IDs](workload-and-component-ids.md). If `--add` is used, only those workloads and components specified with `--add` are downloaded. If `--add` is not used, all workload and components are downloaded.
77
-
* ```--includeRecommended``` to include all the recommended components for the specified workload IDs
78
-
* ```--includeOptional``` to include all the recommended and optional components for the specified workload IDs.
79
-
* ```--lang``` to specify [language locales](use-command-line-parameters-to-install-visual-studio.md#list-of-language-locales).
77
+
*```--add``` to specify [workload or component IDs](workload-and-component-ids.md). If `--add` is used, only those workloads and components specified with `--add` are downloaded. If `--add` is not used, all workload and components are downloaded.
78
+
*```--includeRecommended``` to include all the recommended components for the specified workload IDs
79
+
*```--includeOptional``` to include all the recommended and optional components for the specified workload IDs.
80
+
*```--lang``` to specify [language locales](use-command-line-parameters-to-install-visual-studio.md#list-of-language-locales).
80
81
81
82
Here are a few examples of how to create a custom partial layout.
82
83
83
-
* To download all workloads and components for only one language, run: <br>```vs_enterprise.exe --layout C:\vs2017offline --lang en-US```
84
-
* To download all workloads and components for multiple languages, run: <br>```vs_enterprise.exe --layout C:\vs2017offline --lang en-US de-DE ja-JP```
85
-
* To download one workload for all languages, run <br> ```vs_enterprise.exe --layout C:\vs2017offline --add Microsoft.VisualStudio.Workload.Azure --includeRecommended```
86
-
* To download two workloads and one optional component for three languages, run: <br>```vs_enterprise.exe --layout C:\vs2017offline --add Microsoft.VisualStudio.Workload.Azure --add Microsoft.VisualStudio.Workload.ManagedDesktop --add Component.GitHub.VisualStudio --includeRecommended --lang en-US de-DE ja-JP ```
87
-
* To download two workloads and all of their recommended components, run: <br>```vs_enterprise.exe --layout C:\vs2017offline --add Microsoft.VisualStudio.Workload.Azure --add Microsoft.VisualStudio.Workload.ManagedDesktop --add Component.GitHub.VisualStudio --includeRecommended ```
88
-
* To download two workloads and all of their recommended and optional components, run: <br>```vs_enterprise.exe --layout C:\vs2017offline --add Microsoft.VisualStudio.Workload.Azure --add Microsoft.VisualStudio.Workload.ManagedDesktop --add Component.GitHub.VisualStudio --includeOptional ```
84
+
* To download all workloads and components for only one language, run: <br>```vs_enterprise.exe --layout C:\vs2017offline --lang en-US```
85
+
* To download all workloads and components for multiple languages, run: <br>```vs_enterprise.exe --layout C:\vs2017offline --lang en-US de-DE ja-JP```
86
+
* To download one workload for all languages, run <br> ```vs_enterprise.exe --layout C:\vs2017offline --add Microsoft.VisualStudio.Workload.Azure --includeRecommended```
87
+
* To download two workloads and one optional component for three languages, run: <br>```vs_enterprise.exe --layout C:\vs2017offline --add Microsoft.VisualStudio.Workload.Azure --add Microsoft.VisualStudio.Workload.ManagedDesktop --add Component.GitHub.VisualStudio --includeRecommended --lang en-US de-DE ja-JP ```
88
+
* To download two workloads and all of their recommended components, run: <br>```vs_enterprise.exe --layout C:\vs2017offline --add Microsoft.VisualStudio.Workload.Azure --add Microsoft.VisualStudio.Workload.ManagedDesktop --add Component.GitHub.VisualStudio --includeRecommended ```
89
+
* To download two workloads and all of their recommended and optional components, run: <br>```vs_enterprise.exe --layout C:\vs2017offline --add Microsoft.VisualStudio.Workload.Azure --add Microsoft.VisualStudio.Workload.ManagedDesktop --add Component.GitHub.VisualStudio --includeOptional ```
89
90
90
91
### New in 15.3
92
+
91
93
When you run a layout command, the options that you specify are saved (such as the workloads and languages). Subsequent layout commands will include all of the previous options. Here is an example of a layout with one workload for English only:
When you want to update that layout to a newer version, you don't have to specify any additional command line parameters. The previous settings are saved and used by any subsequent layout commands in this layout folder. The following command will update the existing partial layout.
When you want to update that layout to a newer version, you don't have to specify any additional command line parameters. The previous settings are saved and used by any subsequent layout commands in this layout folder. The following command will update the existing partial layout.
97
98
98
-
```
99
-
vs_enterprise.exe --layout c:\VS2017Layout
100
-
```
99
+
```vs_enterprise.exe --layout c:\VS2017Layout```
101
100
102
101
When you want to add an additional workload, here's an example of how to do so. In this case, we'll add the Azure workload and a localized language. Now, both Managed Desktop and Azure are included in this layout. The language resources for English and German are include for all these workloads. The layout is updated to the latest available version.
Administrators can deploy Visual Studio onto client workstations as part of an installation script. Or, users who have administrator rights can run setup directly from the share to install Visual Studio on their machine.
117
113
118
114
- Users can install by running: <br>```\\server\products\VS2017\vs_enterprise.exe```
@@ -121,9 +117,10 @@ Administrators can deploy Visual Studio onto client workstations as part of an i
121
117
> [!TIP]
122
118
> When executed as part of a batch file, the `--wait` option ensures that the `vs_enterprise.exe` process waits until the installation is complete before it returns an exit code. This is useful if an enterprise administrator wants to perform further actions on a completed installation (for example, to [apply a product key to a successful installation](automatically-apply-product-keys-when-deploying-visual-studio.md)) but must wait for the installation to finish to handle the return code from that installation. If you do not use `--wait`, the `vs_enterprise.exe` process exits before the installation is complete and returns an inaccurate exit code that doesn't represent the state of the install operation.
123
119
124
-
When you install from a layout, the content that is installed is acquired from the layout. However, if something that is selected to be installed is missing in the layout, it will be acquired from the Internet. If you want to prevent Visual Studio setup from downloading any content that is missing in your layout, use the `--noWeb` option. If `--noWeb` is used and the layout is missing any content selected to be installed, setup fails.
120
+
When you install from a layout, the content that is installed is acquired from the layout. However, if you select a component that is not in the layout, it will be acquired from the internet. If you want to prevent Visual Studio setup from downloading any content that is missing in your layout, use the `--noWeb` option. If `--noWeb` is used and the layout is missing any content that is selected to be installed, setup fails.
125
121
126
122
### Error codes
123
+
127
124
If you used the `--wait` parameter, then depending on the result of the operation, the `%ERRORLEVEL%` environment variable is set to one of the following values:
128
125
129
126
|**Value**|**Result**|
@@ -133,15 +130,18 @@ If you used the `--wait` parameter, then depending on the result of the operatio
133
130
| Other | Failure condition occurred - check the logs for more information |
134
131
135
132
## Updating a network install layout
133
+
136
134
As product updates become available, you might want to [update the network install layout](update-a-network-installation-of-visual-studio.md) to incorporate updated packages.
137
135
138
136
## How to create a layout for a previous Visual Studio 2017 release
137
+
139
138
> [!NOTE]
140
139
> The Visual Studio 2017 bootstrappers that are available on [VisualStudio.com](http://www.visualstudio.com) download and install the latest Visual Studio 2017 release available whenever they are run. If you download a Visual Studio bootstrapper today and run it six months from now, it installs the Visual Studio 2017 release that is available at that later time. If you create a layout, installing Visual Studio from that layout installs the specific version of Visual Studio that exists in the layout. Even though a newer version might exist online, you get the version of Visual Studio that is in the layout.
141
140
142
-
If you need to create a layout for an older version of Visual Studio 2017, you can go to https://my.visualstudio.com to download "fixed" versions of the Visual Studio 2017 bootstrappers for supported versions, which allows you to create a network install layout for that older version.
141
+
If you need to create a layout for an older version of Visual Studio 2017, you can go to https://my.visualstudio.com to download "fixed" versions of the Visual Studio 2017 bootstrappers.
143
142
144
143
### How to get support for your offline installer
144
+
145
145
If you experience a problem with your offline installation, we want to know about it. The best way to tell us is by using the [Report a Problem](../ide/how-to-report-a-problem-with-visual-studio-2017.md) tool. When you use this tool, you can send us the telemetry and logs we need to help us diagnose and fix the problem.
146
146
147
147
We have other support options available, too. For a list, see our [Talk to us](../ide/how-to-report-a-problem-with-visual-studio-2017.md) page.
title: "Create an Offline Installation of Visual Studio | Microsoft Docs"
3
+
description: "Find out how to install Visual Studio offline."
4
+
ms.custom: ""
5
+
ms.date: "08/30/2017"
6
+
ms.reviewer: ""
7
+
ms.suite: ""
8
+
ms.technology:
9
+
- "vs-ide-install"
10
+
ms.tgt_pltfrm: ""
11
+
ms.topic: "article"
12
+
f1_keywords:
13
+
- "offline installation [Visual Studio]"
14
+
- "offline install [Visual Studio]"
15
+
- "layout [Visual Studio]"
16
+
ms.assetid: f8625d5e-f6ea-4db0-83c0-619b77fab3cf
17
+
author: "TerryGLee"
18
+
ms.author: "tglee"
19
+
manager: "ghogen"
3
20
---
21
+
# Create an offline installation of Visual Studio 2017
22
+
23
+
We designed the Visual Studio 2017 installer to work well in a wide variety of network and machine conditions.
24
+
25
+
- The new workload-based model means you'll need to download far less than with previous versions of Visual Studio: as little as 300 MB for the smallest installation;
26
+
- Compared to a generic "ISO" or zip file, we download only the packages you need for your machine. For example, we don't download 64-bit files if you don't need them;
27
+
- During the installation process, we try three different download technologies (WebClient, BITS and WinInet) to minimize interference with anti-virus and proxy software;
28
+
- The files you'll need to install Visual Studio are distributed on a global delivery network, so we can get them to you from a local server.
29
+
30
+
We recommend that you try the [Visual Studio web installer](https://aka.ms/vsdownload?utm_source=mscom&utm_campaign=msdocsOL)—we think you'll find it a good experience.
31
+
32
+
> [!div class="button"]
33
+
> [Download Visual Studio 2017](https://aka.ms/vsdownload?utm_source=mscom&utm_campaign=msdocsOL)
34
+
<br/>
35
+
36
+
If you want to install a single instance of Visual Studio 2017 but your internet connection is unavailable or unreliable, see [Install Visual Studio 2017 on low bandwidth or unreliable network environments](../install/install-vs-inconsistent-quality-network.md). You can use the command line to create a local cache of the files you need to complete an offline install. This process replaces the ISO files available for previous versions.
37
+
38
+
> [!NOTE]
39
+
> If you are an enterprise administrator who wants to perform a deployment of Visual Studio 2017 to a network of client workstations that are firewalled from the internet, see our [Create a network installation of Visual Studio 2017](../install/create-a-network-installation-of-visual-studio.md) and [Special considerations for installing Visual Studio in an offline environment](../install/install-visual-studio-in-offline-environment.md) pages.
0 commit comments