Microsoft Remote Desktop URL Scheme

In development, I hope users can launch the RDP app with one click on a web page. URL schemes seem like the answer.

Tests show that RDP URL Scheme support is incomplete.

Platform

1. macOS

   System versions behave differently. Verified: Big Sur works.

   rdp://full%20address=s:<ip>:<port>&username=s:Administrator
   

   Click to test: rdp://full%20address=s:49.232.185.70:3389&username=s:Administrator

   (Copy and paste the above URL into your browser address bar to test)

   Sonoma does not work.

   Failed to launch ‘rdp://full%20address=s:127.0.0.1:3389&username=s:Administrator’ because the scheme does not have a registered handler.

   Manually install RDP

2. Windows

   Only supports launching the RDP client; parameters cannot be passed.

   Click to test: ms-rd://

   (Copy and paste the above URL into your browser address bar to test)

RDP file download

The most reliable approach is to let users download the .rdp file and open it manually. The file content is:

full address:s:9.9.9.9:3389
username:s:administrator

Note: macOS requires manual installation of Microsoft Remote Desktop.

Docs

• https://learn.microsoft.com/en-us/windows-server/remote/remote-desktop-services/clients/remote-desktop-uri