From 8a50dd1778944656d1ef12b8e617e0bc15e33a90 Mon Sep 17 00:00:00 2001 From: Zac Bergquist Date: Fri, 30 Aug 2024 14:21:07 -0600 Subject: [PATCH] docs: add troubleshooting step for directory sharing failures Closes #45461 --- .../desktop-access/troubleshooting.mdx | 25 +++++++++++++++++++ 1 file changed, 25 insertions(+) diff --git a/docs/pages/enroll-resources/desktop-access/troubleshooting.mdx b/docs/pages/enroll-resources/desktop-access/troubleshooting.mdx index 6fe2d29d3cba..02a03171a657 100644 --- a/docs/pages/enroll-resources/desktop-access/troubleshooting.mdx +++ b/docs/pages/enroll-resources/desktop-access/troubleshooting.mdx @@ -393,3 +393,28 @@ to force the policy update: ```code $ gpupdate.exe /force ``` + +## Directory Sharing + +### Failed to share directory + +Attempts to share a directory fail and a warning is presented that says: + +``` +Failed to share directory, drive redirection may be disabled on the RDP server. +``` + +**Solution:** Ensure that device redirection is enabled. + +Teleport's directory sharing feature leverages RDP device redirection. +If device redirection is not enabled or allowed by the RDP server then the operation +will fail. + +Device redirection is typically enabled by default, but may be disabled in group policy. +The relevant settings are located under: + +```text +Computer configuration > Administrative Templates > Windows Components > Remote Desktop Services > Remote Desktop Session Host > Device and Resource Redirection +``` + +Make sure that the option for *Do not allow drive redirection* is unset or disabled.