Enabling administrator updates to Visual Studio with Microsoft Endpoint Configuration Manager
The Microsoft Endpoint Configuration Manager (SCCM) can manage Visual Studio 2017 and Visual Studio 2019 administrator updates by using the Software Update management workflow.
For documentation simplicity, the content below will refer to the Visual Studio 2017, Visual Studio 2019 and Visual Studio 2022 products collectively as "Visual Studio".
When Microsoft publishes a new Visual Studio update to the Content Delivery Network (CDN), Microsoft will simultaneously publish a corresponding administrator update package to the Microsoft Update servers. This will then enable an administrator to distribute the Visual Studio update via the Microsoft Update Catalog (MUC) or Windows Server Update Services (WSUS). Configuration Manager can be set up to synchronize the Visual Studio administrator updates from the WSUS catalog into the site server, and then, it can download the update and distribute it to Visual Studio client machines across the organization. For more information about which fixes are present in each release of Visual Studio, see the release notes.
To distribute Visual Studio administrator updates through Configuration Manager, you’ll need to take these two initial preparation steps:
- Enable Configuration Manager to receive Visual Studio administrator update notifications.
- Enable (or disable) client machines to receive Visual Studio administrator updates from Configuration Manager.
After you perform these steps, you can use the software update management capabilities of Configuration Manager to deploy the Visual Studio administrator updates. The different types and characteristics of Visual Studio administrator updates are described in Applying administrator updates, which provides guidance about how and when they should be distributed throughout your organization. For more information about Configuration Manager functionality and options, see Deploy software updates in Microsoft Endpoint Configuration Manager.
Enable Configuration Manager to receive Visual Studio administrator update notifications
To enable Configuration Manager to manage Visual Studio administrator updates, you will need:
A current licensed version of Windows Server running Microsoft Endpoint Configuration Manager (current branch) and Windows Server Update Services (WSUS). You can’t use WSUS itself to deploy these updates; it must be used in conjunction with Configuration Manager.
The hierarchy’s top-level WSUS server and the top-level Configuration Manager site server must have access to the Visual Studio URLs and ports listed here: Install and use Visual Studio and Azure Services behind a firewall or proxy server.
The Microsoft Endpoint Configuration Manager must be configured to receive notifications when Visual Studio administrator update packages are available. To do that, use the following steps, and for more information, see Introduction to software updates in Microsoft Endpoint Configuration Manager.
In the Configuration Manager console, select Administration (bottom-left), then select Site Configuration (middle left), then Sites, and select your site server.
On the Home tab ribbon at the top, in the Settings group button, select Configure Site Components, and then select Software Update Point.
In the Software Update Point Component Properties dialog box:
On the Products tab, under the Developer Tools, Runtimes, and Redistributables hierarchy, choose the versions of Visual Studio you want to synchronize.
On the Classifications tab, make sure “Security Updates”, “Feature Packs”, and “Updates” are selected.
Next, synchronize the software updates with the WSUS server by choosing Software Library (bottom-left), and then on the Home tab ribbon at the top, select the Synchronize Software Updates button. Synchronizing Software Updates will make the available Visual Studio administrator updates visible in, and able to be deployed from, the Configuration Manager console.
Enable (or disable) client machines' ability to receive Visual Studio administrator updates from Configuration Manager
To enable a client machine to accept Visual Studio administrator updates, you will need to ensure that the Visual Studio Client Detector Utility is installed properly, and you will need to set a registry key to enable the client to receive administrator updates.
Visual Studio Client Detector Utility
The Visual Studio Client Detector Utility must be installed on the client machines in order for the administrator updates to be properly recognized and received. This utility was included with all Visual Studio 2017 and Visual Studio 2019 product updates that were released on or after May 12, 2020, it is includes as a pre-requisite with all the Visual Studio administrator updates, and it is also available on the Microsoft Update Catalog to install independently.
Encoding administrator intent on the client machines
The client computers must be enabled to receive administrator updates. This step is necessary to make sure that the updates are not unintentionally or accidentally pushed out to unsuspecting client computers.
The AdministratorUpdatesEnabled key is designed for the administrator to encode administrator intent. This key can be in any of the standard Visual Studio locations as described in the Set defaults for enterprise deployments of Visual Studio documentation. Admin access on the client computer is required to create and set the value of this key.
- To configure the client computer to accept Administrator Updates, set the AdministratorUpdatesEnabled REG_DWORD key to 1.
- If the AdministratorUpdatesEnabled REG_DWORD key is missing or is set to 0, administrator updates will be blocked from applying to the client computer.
Feedback and 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:
- Report product issues to us via the Report a Problem tool that appears both in the Visual Studio Installer and in the Visual Studio IDE.
- Suggest a feature, track product issues, and find answers in the Visual Studio Developer Community.
- Use your GitHub account to talk to us and other Visual Studio developers in the Visual Studio conversation in the Gitter community.
You can use the following methods to provide feedback about Visual Studio administrator updates or report issues that affect the updates:
- Refer to the Troubleshooting Visual Studio installation and upgrade issues guidance.
- Ask questions to the community at the Visual Studio Setup Q&A Forum.
- Go to the Visual Studio support page, and check whether your issue is listed in the FAQ. You can also select the Support Link button for chat help.
- Provide feature feedback or report a problem to the Visual Studio team regarding this experience of enabling administrator updates.
- Contact your organization’s technical account manager for Microsoft.
- Applying administrator updates
- Visual Studio administrator guide
- Visual Studio Product Lifecycle and Servicing
- Visual Studio 2019 Release Notes
- Visual Studio 2017 Release Notes
- Install Visual Studio
- Microsoft Update Catalog FAQ
- Microsoft Endpoint Configuration Manager (SCCM) documentation
- Import updates from Microsoft Catalog into Configuration Manager
- Windows Server Update Services (WSUS) documentation