Hard-delete the contents of a folder shortcut when unmounted
Explanation
This setting determines the behavior of the Sync client when it encounters a request to unmount a folder shortcut (a folder added to OneDrive via "Add shortcut to OneDrive").
If you enable this setting, when an unmount of a folder shortcut is received, the Sync client will hard-delete all the contents of the folder.
If you disable or do not configure this setting, Sync will by default move the contents of the unmounted folder to the recycle bin.
Registry
HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\OneDrive- Value name
AddedFolderHardDeleteOnUnmount
| 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/AddedFolderHardDeleteOnUnmount
$k = 'HKLM:\SOFTWARE\Policies\Microsoft\OneDrive'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
Set-ItemProperty -Path $k -Name 'AddedFolderHardDeleteOnUnmount' -Value 1 -Type DWordDisable
# Disable: OneDrive/AddedFolderHardDeleteOnUnmount
$k = 'HKLM:\SOFTWARE\Policies\Microsoft\OneDrive'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
Set-ItemProperty -Path $k -Name 'AddedFolderHardDeleteOnUnmount' -Value 0 -Type DWordRevert to "Not configured"
# Revert to "Not configured": OneDrive/AddedFolderHardDeleteOnUnmount
$k = 'HKLM:\SOFTWARE\Policies\Microsoft\OneDrive'
Remove-ItemProperty -Path $k -Name 'AddedFolderHardDeleteOnUnmount' -ErrorAction SilentlyContinueApplication
Microsoft OneDrive (Microsoft) — October 2026 templates
October 2026 templates from pl4nty/web-admx-tool.