Microsoft Remote Desktop URL Scheme

Learn how to use URL Scheme to invoke Microsoft Remote Desktop on macOS and Windows, including limitations and workarounds.

Jan 23, 2024 · 1 min read · 145 Words · -Views -Comments · Digital Life
Windows RDP 🇨🇳 阅读中文版
Read with AI

Choose an AI assistant

ChatGPT Open in a new tab with the article link and prompt
Claude Copy the prompt, then open Claude

Open Claude
Trouble reading the article?

If the prompt is missing, copy the full prompt below into your AI assistant. If the AI cannot read the article, paste the visible passage you want to discuss and add your question.

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

Authors
Developer, digital product enthusiast, tinkerer, sharer, open source lover