From 2130bd428a3948de71212d8b181ba8d2f4b40deb Mon Sep 17 00:00:00 2001 From: Zac Bergquist Date: Thu, 5 Sep 2024 11:32:48 -0600 Subject: [PATCH] docs: add troubleshooting step for directory sharing failures (#46166) 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 6fe2d29d3cba0..02a03171a6577 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.