Control updates to network-based Visual Studio deployments

Enterprise administrators often create a layout and host it on a network file share to deploy to their end users. This page describes how to configure your network layout options properly.

Controlling where Visual Studio looks for updates

Scenario 1: Client originally installed from a layout, but is configured to receive updates from either the network layout location or the web

By default, Visual Studio continues to look online for updates even if the installation was originally deployed from a network share. If an update is available on the web, then the user can install it. Although the network layout cache is inspected first for any updated product bits, if they are not found there, then Visual Studio will look for and download updated product bits from the web.

Scenario 2: Client originally installed and should only receive updates from the network layout

If you want to control where the Visual Studio client looks for updates, for example, if your client machine does not have internet access and you want to ensure that it only and always installs from the layout, then you can configure the location where the client's installer looks for updated product bits. It is best to make sure this setting is configured correctly before the client does the initial install from the layout.

  1. Create an offline layout:

    vs_enterprise.exe --layout C:\vsoffline --lang en-US
    
  2. Copy it to the file share where you want to host it:

    xcopy /e C:\vsoffline \\server\share\VS
    
  3. Modify the response.json file in the layout and change the channelUri value to point to a copy of the channelManifest.json that the admin controls.

    Be sure to escape backslashes in the value, as in the following example:

    "channelUri":"\\\\server\\share\\VS\\ChannelManifest.json"
    

    Now end users can run setup from this share to install Visual Studio.

    \\server\share\VS\vs_enterprise.exe
    

When an enterprise administrator determines it is time for their users to update to a newer version of Visual Studio, they can update the layout location to incorporate the updated files, as follows.

  1. Use a command that is similar to the following command:

    vs_enterprise.exe --layout \\server\share\VS --lang en-US
    
  2. Ensure that the response.json file in the updated layout still contains your customizations, specifically the channelUri modification, as follows:

    "channelUri":"\\\\server\\share\\VS\\ChannelManifest.json"
    

Existing Visual Studio installs from this layout look for updates at \\server\share\VS\ChannelManifest.json. If the channelManifest.json is newer than what the user has installed, Visual Studio notifies the user that an update is available.

Any installation update initiated from the client will automatically install the updated version of Visual Studio directly from the layout.

Scenario 3: Client originally installed from the web, but now should only receive updates from a network layout

In some cases, the client machine may have already installed Visual Studio from the web, but now the administrator wants to have all future updates come from a managed layout. The only supported way to do this is to create a network layout with the desired version of the product, and then on the client machine, run the bootstrapper from the layout location (e.g. \\server\share\vs_enterprise.exe). Ideally, the original client install would have happened using the bootstrapper from the network layout with the correctly configured ChannelURI, but running the updated bootstrapper from the network layout location will also work. Either one of these actions would embed, on the client machine, a connection with that particular layout location. The only caveat for this scenario to work correctly is that the “ChannelURI” in the layout’s response.json file must be the same as the ChannelURI that was set on the client’s machine when the original install happened. Most likely this value was originally set to the internet release channel.

Controlling notifications in the Visual Studio IDE

As described earlier, Visual Studio checks the location from which it has been installed, such as a network share or the internet, to see whether any updates are available. When an update is available, Visual Studio notifies the user with a notification flag in the top right-hand corner of the window.

Notification flag for updates

As described earlier, Visual Studio checks the location from which it has been installed, such as a network share or the internet, to see whether any updates are available. When an update is available, Visual Studio notifies the user with a notification icon in the lower right-hand corner of the window.

The notification icon in the Visual Studio IDE

You can disable the notifications if you don't want end users to be notified of updates. (For example, you might want to disable notifications if you deliver updates through a central software distribution mechanism.)

Because Visual Studio 2017 stores registry entries in a private registry, you can't directly edit the registry in the typical way. However, Visual Studio includes a vsregedit.exe utility that you can use to change Visual Studio settings. You can turn off notifications with the following command:

vsregedit.exe set "C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise" HKCU ExtensionManager AutomaticallyCheckForUpdates2Override dword 0

Because Visual Studio 2019 stores registry entries in a private registry, you can't directly edit the registry in the typical way. However, Visual Studio includes a vsregedit.exe utility that you can use to change Visual Studio settings. You can turn off notifications with the following command:

vsregedit.exe set "C:\Program Files (x86)\Microsoft Visual Studio\2019\Enterprise" HKCU ExtensionManager AutomaticallyCheckForUpdates2Override dword 0

Because Visual Studio 2022 stores registry entries in a private registry, you can't directly edit the registry in the typical way. However, Visual Studio includes a vsregedit.exe utility that you can use to change Visual Studio settings. You can turn off notifications with the following command:

vsregedit.exe set "C:\Program Files\Microsoft Visual Studio\2022\Enterprise" HKCU ExtensionManager AutomaticallyCheckForUpdates2Override dword 0

(Make sure to replace the directory to match the installed instance that you want to edit.)

Tip

Use vswhere.exe to find a specific instance of Visual Studio on a client workstation.

Get support

Sometimes, things can go wrong. If your Visual Studio installation fails, see Troubleshoot Visual Studio installation and upgrade issues for step-by-step guidance.

We also offer an installation chat (English only) support option for installation-related issues.

Here are a few more support options:

See also