Cause sync client to ignore normal web proxy detection logic
Explanation
This setting controls whether the OneDrive sync client does its default web proxy detection logic or not.
If you enable this setting, the sync client will not do its normal web proxy detection and will attempt direct connections to the internet web endpoints it needs to communicate with. This is equivalent of having no web proxy settings configured and no automatic proxy script.
If you disable or do not configure this setting, the sync client will detect if a web proxy is configured on your network and use it if so.
For more info see https://learn.microsoft.com/troubleshoot/windows-server/networking/configure-proxy-server-settings
Registry
HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\OneDrive- Value name
IgnoreWebProxy
| State | Value written |
|---|---|
| Enabled | REG_DWORD = 1 |
| Disabled | REG_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: OneDrive/IgnoreWebProxy
$k = 'HKLM:\SOFTWARE\Policies\Microsoft\OneDrive'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
Set-ItemProperty -Path $k -Name 'IgnoreWebProxy' -Value 1 -Type DWordDisable
# Disable: OneDrive/IgnoreWebProxy
$k = 'HKLM:\SOFTWARE\Policies\Microsoft\OneDrive'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
Set-ItemProperty -Path $k -Name 'IgnoreWebProxy' -Value 0 -Type DWordRevert to "Not configured"
# Revert to "Not configured": OneDrive/IgnoreWebProxy
$k = 'HKLM:\SOFTWARE\Policies\Microsoft\OneDrive'
Remove-ItemProperty -Path $k -Name 'IgnoreWebProxy' -ErrorAction SilentlyContinueApplication
Microsoft OneDrive (Microsoft) — October 2026 templates
October 2026 templates from pl4nty/web-admx-tool.