Open in the explorer

Hard-delete the contents of a folder shortcut when user loses permissions to the folder

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

Explanation

This setting determines the behavior of the Sync client when the user loses permissions to a folder shortcut (a folder added to OneDrive via "Add shortcut to OneDrive").

If you enable this setting, when the Sync client detects that the user lost permissions to a folder shortcut, the Sync client will hard-delete all the contents of the folder and the folder itself.

If you disable or do not configure this setting, Sync will by default mark the folder in error and prompt the user to remove it. When the user confirms the removal, the contents of the folder are moved to the recycle bin.

Registry

HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\OneDrive
Value name
AddedFolderUnmountOnPermissionsLoss
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/AddedFolderUnmountOnPermissionsLoss
$k = 'HKLM:\SOFTWARE\Policies\Microsoft\OneDrive'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
Set-ItemProperty -Path $k -Name 'AddedFolderUnmountOnPermissionsLoss' -Value 1 -Type DWord

Disable

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

Revert to "Not configured"

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

Application

Microsoft OneDrive (Microsoft) — October 2026 templates

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