Configure device redirection
Configuring device redirection for your Azure Virtual Desktop environment allows you to use printers, USB devices, microphones, and other peripheral devices in the remote session. Some device redirections require changes to both Remote Desktop Protocol (RDP) properties and Group Policy settings.
Supported device redirection
Each client supports different kinds of device redirections. Check out Compare the clients for the full list of supported device redirections for each client.
You can only enable redirections with binary settings that apply to both to and from the remote machine.
Customizing RDP properties for a host pool
To learn more about customizing RDP properties for a host pool using PowerShell or the Azure portal, check out RDP properties. For the full list of supported RDP properties, see Supported RDP file settings.
Setup device redirection
You can use the following RDP properties and Group Policy settings to configure device redirection.
Audio input (microphone) redirection
Set the following RDP property to configure audio input redirection:
audiocapturemode:i:1enables audio input redirection.
audiocapturemode:i:0disables audio input redirection.
Audio output (speaker) redirection
Set the following RDP property to configure audio output redirection:
audiomode:i:0enables audio output redirection.
audiomode:i:2disable audio output redirection.
Set the following RDP property to configure camera redirection:
camerastoredirect:s:*redirects all cameras.
camerastoredirect:s:disables camera redirection.
Even if the
camerastoredirect:s: property is disabled, local cameras may be redirected through the
devicestoredirect:s: property. To fully disable camera redirection set
camerastoredirect:s: and either set
devicestoredirect:s: or define some subset of plug and play devices that does not include any camera.
You can also redirect specific cameras using a semicolon-delimited list of KSCATEGORY_VIDEO_CAMERA interfaces, such as
Set the following RDP property to configure clipboard redirection:
redirectclipboard:i:1enables clipboard redirection.
redirectclipboard:i:0disables clipboard redirection.
COM port redirection
Set the following RDP property to configure COM port redirection:
redirectcomports:i:1enables COM port redirection.
redirectcomports:i:0disables COM port redirection.
To redirect a mass storage USB device connected to your local computer to the remote session host, you'll need to configure the Drive/storage redirection RDP property. Enabling the USB redirection RDP property by itself won't work. For more information, see Local drive redirection.
First, set the following RDP property to enable USB device redirection:
usbdevicestoredirect:s:*enables USB device redirection.
usbdevicestoredirect:s:disables USB device redirection.
Second, set the following Group Policy on the user's local device:
- Navigate to Computer Configuration > Policies> Administrative Templates > Windows Components > Remote Desktop Services > Remote Desktop Connection Client > RemoteFX USB Device Redirection.
- Select Allows RDP redirection of other supported RemoteFX USB devices from this computer.
- Select the Enabled option, and then select the Administrators and Users in RemoteFX USB Redirection Access Rights box.
- Select OK.
Plug and play device redirection
Set the following RDP property to configure plug and play device redirection:
devicestoredirect:s:*enables redirection of all plug and play devices.
devicestoredirect:s:disables redirection of plug and play devices.
You can also select specific plug and play devices using a semicolon-delimited list, such as
Local drive redirection
Set the following RDP property to configure local drive redirection:
drivestoredirect:s:*enables redirection of all disk drives.
drivestoredirect:s:disables local drive redirection.
You can also select specific drives using a semicolon-delimited list, such as
To enable web client file transfer, set
drivestoredirect:s:*. If you set any other value for this RDP property, web client file transfer will be disabled.
Set the following RDP property to configure location redirection:
redirectlocation:i:1enables location redirection.
redirectlocation:i:0disables location redirection.
When enabled, the location of the local device is sent to the session host and set as its location. Location redirection lets applications like Maps or Printer Search use your physical location. When you disable location redirection, these applications will use the location of the session host instead.
Set the following RDP property to configure printer redirection:
redirectprinters:i:1enables printer redirection.
redirectprinters:i:0disables printer redirection.
Smart card redirection
Set the following RDP property to configure smart card redirection:
redirectsmartcards:i:1enables smart card redirection.
redirectsmartcards:i:0disables smart card redirection.
Set the following RDP property to configure WebAuthn redirection:
redirectwebauthn:i:1enables WebAuthn redirection.
redirectwebauthn:i:0disables WebAuthn redirection.
When enabled, WebAuthn requests from the session are sent to the local PC to be completed using the local Windows Hello for Business or security devices like FIDO keys. For more information, see In-session passwordless authentication.