Open in the explorer

Hard-delete the contents of a folder shortcut when unmounted

Type
Computer
GPO path
Computer Configuration › Policies › Administrative Templates › OneDrive
Supported on
SUPPORTED_Windows_10_0_TH1
ADMX file
OneDrive.admx
Internal name
OneDrive/AddedFolderHardDeleteOnUnmount

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
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: 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 DWord

Disable

# 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 DWord

Revert to "Not configured"

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

Application

Microsoft OneDrive (Microsoft) — October 2026 templates

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