Wiki source code of FreeRDP - USB-Weiterleitung unterstützter Plug&Play Geräte
Last modified by Tobias Wintrich on 2026/01/02 09:09
Hide last authors
| author | version | line-number | content |
|---|---|---|---|
| |
37.2 | 1 | (% class="box infomessage" %) |
| 2 | ((( | ||
| |
44.1 | 3 | Last successfully tested: |
| |
38.1 | 4 | Firmware: x64 – 13.00 Build: 145 |
| |
44.1 | 5 | FreeRDP version: freerdp 3.19-x64 – 13.00 Build 002 |
| |
37.2 | 6 | ))) |
| |
27.2 | 7 | |
| |
28.1 | 8 | (% class="box warningmessage" %) |
| 9 | ((( | ||
| |
44.1 | 10 | This guide does *not* refer to the redirection of connected storage devices (USB sticks, cameras, SD card readers, etc.), smart cards, and webcams. |
| |
35.1 | 11 | |
| |
44.1 | 12 | Storage devices can be configured separately via {{status title="GLOBAL SETTINGS"/}} → {{status title="DRIVE SETTINGS"/}}. |
| |
38.1 | 13 | |
| |
44.1 | 14 | For smart card passthrough, it is sufficient to enable the {{status title="Smartcard"/}} option within the FreeRDP connection settings. |
| |
38.1 | 15 | |
| |
44.1 | 16 | The use of webcams is described here: |
| 17 | [[FreeRDP – Webcam Redirection>>doc:HowTos.FreeRDP - Webcam Weiterleitung.WebHome]] | ||
| |
28.1 | 18 | ))) |
| |
27.2 | 19 | |
| 20 | {{toc/}} | ||
| 21 | |||
| |
44.1 | 22 | = Server Settings = |
| |
27.2 | 23 | |
| |
44.1 | 24 | Ensure that the integration of redirected USB devices is allowed on the server side. |
| 25 | By default, this function is disabled and must first be enabled via Group Policy. | ||
| |
27.2 | 26 | |
| |
44.1 | 27 | == Group Policy == |
| |
27.2 | 28 | |
| |
44.1 | 29 | The required settings can be found in the Group Policy Editor (locally or in the domain) under: |
| |
27.2 | 30 | |
| |
44.1 | 31 | Computer Configuration |
| 32 | → Administrative Templates | ||
| 33 | → Windows Components | ||
| 34 | → Remote Desktop Services | ||
| 35 | → Remote Desktop Session Host | ||
| 36 | → Device and Resource Redirection | ||
| 37 | → “Do not allow supported Plug and Play device redirection” | ||
| 38 | → {{status title="Disabled"/}} | ||
| |
27.2 | 39 | |
| |
28.1 | 40 | (% class="box warningmessage" %) |
| 41 | ((( | ||
| |
44.1 | 42 | On our test servers, a {{status title="gpupdate /force"/}} on the respective server was not sufficient. |
| 43 | Only after a restart was the new policy applied correctly. | ||
| |
28.1 | 44 | ))) |
| |
27.2 | 45 | |
| |
41.1 | 46 | [[image:1767340074163-720.png]] |
| |
27.2 | 47 | |
| |
44.1 | 48 | == Session Collection Configuration == |
| |
32.1 | 49 | |
| |
44.1 | 50 | Additionally, ensure that redirection of supported Plug & Play devices is allowed within the session collection configuration. |
| 51 | By default, this option is enabled. | ||
| |
32.1 | 52 | |
| |
44.1 | 53 | To do so, select the session collection to be configured in the Server Manager under {{status title="Remote Desktop Services"/}} and navigate via |
| 54 | {{status title="Tasks"/}} → {{status title="Edit Properties"/}} to the {{status title="Client Settings"/}}. | ||
| |
32.1 | 55 | |
| |
44.1 | 56 | Verify that the option {{status title="Plug & Play Devices"/}} is enabled. |
| |
27.2 | 57 | |
| |
41.1 | 58 | [[image:1767340122785-875.png||height="644" width="800"]] |
| |
27.2 | 59 | |
| |
28.1 | 60 | (% class="box warningmessage" %) |
| 61 | ((( | ||
| |
44.1 | 62 | A server restart is required to fully apply the settings. |
| |
28.1 | 63 | ))) |
| |
27.2 | 64 | |
| |
44.1 | 65 | = Client Settings = |
| |
27.2 | 66 | |
| |
44.1 | 67 | Identify your USB device in the Kommbox via {{status title="Peripherals"/}} → {{status title="USB Devices"/}} and note the VID:PID combination (vendor and product ID). |
| |
27.2 | 68 | |
| |
44.1 | 69 | [[image:01_usb-devices_en.png||height="396" width="800"]] |
| |
27.2 | 70 | |
| |
44.1 | 71 | Transfer the determined USB device VID:PID combination into the FreeRDP configuration. |
| |
27.2 | 72 | |
| |
28.1 | 73 | (% class="box warningmessage" %) |
| 74 | ((( | ||
| |
44.1 | 75 | Do **not** check the option {{status title="USB Redirection (FabulaTech)"/}}. |
| 76 | This type of redirection requires the paid “USB Server” module from FabulaTech. | ||
| |
28.1 | 77 | ))) |
| |
27.2 | 78 | |
| |
44.1 | 79 | [[image:02_freerdp_en.png||height="400" width="800"]] |
| |
27.2 | 80 | |
| |
44.1 | 81 | As soon as you establish the connection, the redirected USB device will appear in Device Manager. |
| |
32.1 | 82 | |
| |
44.1 | 83 | In this example, it is a Lenovo webcam: |
| |
32.1 | 84 | |
| 85 | {{lightbox image="dokugeräte.png" group="1"/}} |