Microsoft Remote Desktop URL Scheme

Posted on Edited on Word count in article: 947 Reading time ≈ 2 mins.
Learn how to use URL Scheme to invoke Microsoft Remote Desktop on MacOS and Windows. Understand the limitations and workarounds for different platforms.

In development, I hope that user can invoke the RDP app by one click on the web page. I think URL Scheme is the answer.

Actual tests have found that the support for RDP URL Scheme is incomplete.

Platform

  1. MacOS

    System version has behave different, actual verification: BigSur supports ok.

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

    Click to test

    Sonoma 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.

    manual install RDP

  2. Windows

    Only supports launching the RDP client, but cannot pass any parameter.

    Click to test

RDP File Download

The currently perfect support is for users to manually download the .rdp file and open it manually. The File content is followdings.

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

注意MacOS需手动安装Microsoft Remote Desktop

Note: Microsoft Remote Desktop is required in MacOS.

Docs