Open in the explorer

UpdateRestartWhenIdle

Type
Computer and user
GPO path
Computer Configuration › Policies › Administrative Templates › Visual Studio Code › Update User Configuration › Policies › Administrative Templates › Visual Studio Code › Update
Supported on
Visual Studio Code >= 1.145
ADMX file
VSCode.admx
Internal name
VSCode/UpdateRestartWhenIdle

Explanation

Controls whether to restart automatically to apply a downloaded update after the screen has been locked for a minute while on power, keeping the machine from going to sleep until then. The restart only happens if every window can be restored exactly as it was, for example when no terminal process, task, debug session, chat request, or agent session is running, and it does not take focus from another application. Only supported on macOS.

Registry

HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\VSCode
HKEY_CURRENT_USER\Software\Policies\Microsoft\VSCode
Value name
not defined in the ADMX

Enable / disable values: not defined in the ADMX (see the options below).

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.

Computer (HKLM)

Enable

# Enable: VSCode/UpdateRestartWhenIdle
$k = 'HKLM:\Software\Policies\Microsoft\VSCode'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
# UpdateRestartWhenIdle
# unchecked: 0
Set-ItemProperty -Path $k -Name 'UpdateRestartWhenIdle' -Value 1 -Type DWord

Disable

# Disable: VSCode/UpdateRestartWhenIdle
# No value is written in the "Disabled" state (nothing defined in the ADMX)

Revert to "Not configured"

# Revert to "Not configured": VSCode/UpdateRestartWhenIdle
$k = 'HKLM:\Software\Policies\Microsoft\VSCode'
Remove-ItemProperty -Path $k -Name 'UpdateRestartWhenIdle' -ErrorAction SilentlyContinue

User (HKCU)

Enable

Disable

Revert to "Not configured"

Options (1)

LabelControlRegistry valueREG typeConstraints / details
UpdateRestartWhenIdleUpdateRestartWhenIdleCheck boxbooleanUpdateRestartWhenIdleREG_DWORD
Checked: REG_DWORD = 1
Unchecked: REG_DWORD = 0

Application

Visual Studio Code (Microsoft) — November 2026 templates

Official templates downloaded on November 12, 2026.