Open in the explorer

Remove out-of-support components during updates

Type
Computer
GPO path
Computer Configuration › Policies › Administrative Templates › Visual Studio › Install and Update Settings
Supported on
Visual Studio 2022 and higher.
ADMX file
VisualStudio.admx
Internal name
VisualStudio/RemoveOutOfSupport

Explanation

This setting will cause updates to automatically remove all components from all Visual Studio installations that have transitioned to an out-of-support state.

If set to 1 (enabled), then the Visual Studio installer will remove all out-of-support components during all subsequent updates.

If set to 0 (disabled) or missing entirely, then the remove out-of-support components behavior will respect other locations where this can be configured, such as commandline parameter or the Update Settings dialog.

This functionality requires the Visual Studio 2022 version 17.4 installer to be installed on the client machine.

For more information, see https://aka.ms/vs/setup/policies.

Registry

HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\VisualStudio\Setup
Value name
RemoveOos
StateValue written
EnabledREG_DWORD = 1
DisabledREG_DWORD = 0

PowerShell

PowerShell commands that write to the registry what the policy would write. Values in angle brackets (<…>) must be replaced.

Writing directly to the registry bypasses Group Policy: if a GPO manages this value, it will be rewritten at the next gpupdate; otherwise the value stays in place (the "tattooing" effect). Prefer a GPO or, locally, LGPO.exe. Run PowerShell as administrator for HKLM. Some policies need a restart or gpupdate /force.

Enable

# Enable: VisualStudio/RemoveOutOfSupport
$k = 'HKLM:\SOFTWARE\Policies\Microsoft\VisualStudio\Setup'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
Set-ItemProperty -Path $k -Name 'RemoveOos' -Value 1 -Type DWord

Disable

# Disable: VisualStudio/RemoveOutOfSupport
$k = 'HKLM:\SOFTWARE\Policies\Microsoft\VisualStudio\Setup'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
Set-ItemProperty -Path $k -Name 'RemoveOos' -Value 0 -Type DWord

Revert to "Not configured"

# Revert to "Not configured": VisualStudio/RemoveOutOfSupport
$k = 'HKLM:\SOFTWARE\Policies\Microsoft\VisualStudio\Setup'
Remove-ItemProperty -Path $k -Name 'RemoveOos' -ErrorAction SilentlyContinue

Application

Visual Studio (+ Dev Tunnels) (Microsoft) — October 2026 templates

October 2026 templates from pl4nty/web-admx-tool.