Hard-delete the contents of a folder shortcut when user loses permissions to the folder
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
| 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/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 DWordDisable
# 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 DWordRevert to "Not configured"
# Revert to "Not configured": OneDrive/AddedFolderUnmountOnPermissionsLoss
$k = 'HKLM:\SOFTWARE\Policies\Microsoft\OneDrive'
Remove-ItemProperty -Path $k -Name 'AddedFolderUnmountOnPermissionsLoss' -ErrorAction SilentlyContinueApplication
Microsoft OneDrive (Microsoft) — October 2026 templates
October 2026 templates from pl4nty/web-admx-tool.