Remotedesktop-URI-Schema
Gilt für: Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows 11, Windows 10
In diesem Dokument wird das Format von URIs (Uniform Resource Identifier) für Remotedesktop definiert. Mithilfe dieser URI-Schemas können Remotedesktopclients mit verschiedenen Befehlen aufgerufen werden.
ms-rd-URI-Schema
Hinweis
Das ms-rd-URI-Schema wird derzeit nur für den Windows-Desktopclient (MSRDC) unterstützt.
Der ms-rd-URI bietet die Option, einen Befehl für den Client und eine Reihe von Parametern anzugeben, die für den Befehl spezifisch sind. Dabei wird folgendes Format verwendet:
ms-rd:command?parameters
Parameter verwenden das Abfragezeichenfolgen-Format des Schlüssel=Wert-Paars, durch & getrennt, um zusätzliche Informationen für den angegebenen Befehl bereitzustellen:
param1=value1¶m2=value2&…
Befehle und Parameter
Hier findest du eine Liste der derzeit unterstützten Befehle und der entsprechenden Parameter.
Bei Verwendung von ms-rd: ohne Befehle wird der Client gestartet.
Subscribe
Dieser Befehl startet den Client und den Abonnementprozess.
Befehlsname: subscribe
Befehlsparameter:
| Parameter | BESCHREIBUNG | Werte |
|---|---|---|
| URL | Gibt die Arbeitsbereichs-URL an. | Eine gültige URL, z. B. https://contoso.com. |
Beispiel: ms-rd:subscribe?url=https://contoso.com
Legacy rdp-URI-Schema
Hinweis
Das folgende URI-Schema wird nur für die Clients für macOS-, iOS- und Android-Geräte unterstützt. Es wird durch den oben stehenden neuen ms-rd-URI ersetzt.
Microsoft-Remotedesktop verwendet das URI-Schema „rdp://Abfragezeichenfolge“ zum Speichern vorkonfigurierter Attributeinstellungen, die beim Starten des Clients verwendet werden. Die Abfragezeichenfolgen stellen ein oder mehrere RDP-Attribute dar, die in der URL bereitgestellt werden.
Die RDP-Attribute werden durch das kaufmännische Und-Zeichen (&) getrennt. Bei einer Verbindung mit einem PC lautet die Zeichenfolge zum Beispiel wie folgt:
rdp://full%20address=s:mypc:3389&audiomode=i:2&disable%20themes=i:1
Diese Tabelle enthält eine vollständige Liste der unterstützten Attribute, die mit dem iOS, Mac und Android Remotedesktopclients verwendet werden kann. (Ein „X“ in der Spalte mit der Plattform gibt an, dass das Attribut unterstützt wird. Die in spitzen Klammern (<>) eingeschlossenen Werte sind die von den Remotedesktopclients unterstützten Werte.)
| RDP-Attribut | Android | Mac | iOS |
|---|---|---|---|
| allow desktop composition=i:<0 oder 1> | x | x | x |
| allow font smoothing=i:<0 oder 1> | x | x | x |
| alternate shell=s:<Zeichenfolge> | x | x | x |
| audiomode=i:<0, 1 oder 2> | x | x | x |
| authentication level=i:<0 oder 1> | x | x | x |
| connect to console=i:<0 oder 1> | x | x | x |
| disable cursor settings=i:<0 oder 1> | x | x | x |
| disable full window drag=i:<0 oder 1> | x | x | x |
| disable menu anims=i:<0 oder 1> | x | x | x |
| disable themes=i:<0 oder 1> | x | x | x |
| disable wallpaper=i:<0 oder 1> | x | x | x |
| drivestoredirect=s:* (Dies ist der einzige unterstützte Wert) | x | x | |
| desktopheight=i:<Wert in Pixeln> | x | ||
| desktopwidth=i:<Wert in Pixeln> | x | ||
| domain=s:<Zeichenfolge> | x | x | x |
| full address=s:<Zeichenfolge> | x | x | x |
| gatewayhostname=s:<Zeichenfolge> | x | x | x |
| gatewayusagemethod=i:<1 oder 2> | x | x | x |
| prompt for credentials on client=i:<0 oder 1> | x | ||
| loadbalanceinfo=s:<Zeichenfolge> | x | x | x |
| redirectprinters=i:<0 oder 1> | x | ||
| remoteapplicationcmdline=s:<Zeichenfolge> | x | x | x |
| remoteapplicationmode=i:<0 oder 1> | x | x | x |
| remoteapplicationprogram=s:<Zeichenfolge> | x | x | x |
| shell working directory=s:<Zeichenfolge> | x | x | x |
| Use redirection server name=i:<0 oder 1> | x | x | x |
| username=s:<Zeichenfolge> | x | x | x |
| screen mode id=i:<1 oder 2> | x | ||
| session bpp=i:<8, 15, 16, 24 oder 32> | x | ||
| use multimon=i:<0 oder 1> | x |