Skip to main content

Register a RDP Software to use with XOA on windows

VKB-1117How-to
📦 Applies to
Xen Orchestra
🗓️ Created
2025-03-06
🔄 Updated
2025-03-06

Environment​

  • A Windows client machine used to access Xen Orchestra.
  • An RDP client (by default this will use Microsoft mstsc).

Procedure​

To register a software to use with the RDP button on Windows you can use the following registry key (source: https://gist.github.com/jeremyrsellars/364ea48ea067505037ef):

Windows Registry Editor Version 5.00

[HKEY_CLASSES_ROOT\rdp]
@="URL:Remote Desktop Protocol <URL:Remote%20Desktop%20Protocol> "
"EditFlags"=dword:00000002
"URL Protocol"=""

[HKEY_CLASSES_ROOT\rdp\shell]

[HKEY_CLASSES_ROOT\rdp\shell\open]

[HKEY_CLASSES_ROOT\rdp\shell\open\command]
@="cmd /V:ON /c setlocal && set url=%1 && set url=!url:rdp://=! && set url=!url:/=! && start mstsc.exe /v:!url!"

Verification​

Once the registry key is applied, rdp:// links from the RDP button open the registered software (Microsoft mstsc by default).