Skip to content

Commit ae1e4ae

Browse files
authored
Merge pull request #3913 from TerryGLee/tglee-vsinstall
[install] clarify info about the --noWeb command-line parameter
2 parents d6bfcfb + 4c33f85 commit ae1e4ae

File tree

2 files changed

+6
-4
lines changed

2 files changed

+6
-4
lines changed

docs/install/create-a-network-installation-of-visual-studio.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: "Create a network-based installation"
33
description: "Learn how to create a network install point for deploying Visual Studio within an enterprise."
4-
ms.date: 01/15/2019
4+
ms.date: 02/12/2019
55
ms.custom: "seodec18"
66
ms.topic: conceptual
77
helpviewer_keywords:
@@ -117,8 +117,10 @@ Administrators can deploy Visual Studio onto client workstations as part of an i
117117
> [!TIP]
118118
> 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.
119119
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.
120121

121-
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.
122+
> [!IMPORTANT]
123+
> The `--noWeb` option does not stop Visual Studio setup from checking for updates. For more information, see the [Control updates to network-based Visual Studio deployments](controlling-updates-to-visual-studio-deployments.md) page.
122124
123125
### Error codes
124126

docs/install/use-command-line-parameters-to-install-visual-studio.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: "Use command-line parameters to install Visual Studio"
33
titleSuffix: ""
44
description: "Learn how to use command-line parameters to control or customize your Visual Studio installation."
5-
ms.date: 11/14/2018
5+
ms.date: 02/12/2019
66
ms.custom: "seodec18"
77
ms.topic: conceptual
88
f1_keywords:
@@ -101,7 +101,7 @@ The command-line options are used in conjunction with the setup bootstrapper, wh
101101
| `--cache` | **New in 15.2, optional**: If present, packages will be kept after being installed for subsequent repairs. This overrides the global policy setting to be used for subsequent installs, repairs, or modifications. The default policy is to cache packages. This is ignored for the uninstall command. Read how to [disable or move the package cache](disable-or-move-the-package-cache.md) for more information. |
102102
| `--nocache` | **New in 15.2, optional**: If present, packages will be deleted after being installed or repaired. They will be downloaded again only if needed and deleted again after use. This overrides the global policy setting to be used for subsequent installs, repairs, or modifications. The default policy is to cache packages. This is ignored for the uninstall command. Read how to [disable or move the package cache](disable-or-move-the-package-cache.md) for more information. |
103103
| `--noUpdateInstaller` | **New in 15.2, optional**: If present, prevents the installer from updating itself when quiet is specified. The installer will fail the command and return a non-zero exit code if noUpdateInstaller is specified with quiet when an installer update is required. |
104-
| `--noWeb` | **New in 15.3, optional**: Setup now downloads any content that it is installing from the Internet. All content that is being installed must be available in an offline layout. If the layout is missing content, setup fails. For more information, see [Deploying from a network installation](create-a-network-installation-of-visual-studio.md). |
104+
| `--noWeb` | **New in 15.3, optional**: If present, Visual Studio setup uses the files in your layout directory to install Visual Studio. If a user tries to install components that are not in the layout, setup fails. For more information, see [Deploying from a network installation](create-a-network-installation-of-visual-studio.md). <br/><br/> **Important**: This switch does not stop Visual Studio setup from checking for updates. For more information, see [Control updates to network-based Visual Studio deployments](controlling-updates-to-visual-studio-deployments.md).|
105105
| `--path <name>=<path>` | **New in 15.7, optional**: Used to specify custom install paths for the installation. Supported path names are shared, cache, and install. |
106106
| `--path cache=<path>` | **New in 15.7, optional**: Uses the location you specify to download installation files. This location can only be set the first time that Visual Studio is installed. Example: `--path cache="C:\VS\cache"` |
107107
| `--path shared=<path>` | **New in 15.7, optional**: Contains shared files for side-by-side Visual Studio installations. Some tools and SDKs install to a location on this drive, while some others might override this setting and install to another drive. Example: `--path shared="C:\VS\shared"` <br><br>Important: This can be set only once and on the first time that Visual Studio is installed. |

0 commit comments

Comments
 (0)