Schema URI di Desktop remoto

Si applica a: Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows 11, Windows 10

Questo documento definisce il formato degli URI (Uniform Resource Identifier) per Desktop remoto. Questi schemi URI consentono di richiamare i client Desktop remoto con vari comandi.

Schema URI ms-rd

Nota

Lo schema URI ms-rd è attualmente supportato solo con il client desktop di Windows.

L'URI ms-rd consente di specificare un comando per il client e un set di parametri specifici del comando usando il formato seguente:

ms-rd:command?parameters

Parameters usa il formato della stringa di query costituita da coppie chiave=valore separate da & per fornire informazioni aggiuntive sul comando specificato:

param1=value1&param2=value2&…

Comandi e parametri

Ecco l'elenco dei comandi attualmente supportati e dei parametri corrispondenti.

L'uso di ms-rd: senza comandi avvia il client.

Sottoscrivere

Questo comando avvia il client e il processo di sottoscrizione.

Nome del comando: subscribe

Parametri del comando:

Parametro Descrizione Valori
url Specifica l'URL dell'area di lavoro. Un URL valido, ad esempio https://contoso.com.

Esempio: ms-rd:subscribe?url=https://contoso.com

Schema URI rdp legacy

Nota

Lo schema URI seguente è supportato solo con i client per dispositivi macOS, iOS e Android. Verrà sostituito con il nuovo URI ms-rd precedente.

Desktop remoto Microsoft usa lo schema URI rdp://query_string per archiviare le impostazioni di attributi preconfigurati che vengono usate quando si avvia il client. Le stringhe di query rappresentano un singolo attributo o un set di attributi RDP forniti nell'URL.

Gli attributi RDP sono separati dal simbolo e commerciale (&). Ad esempio, quando ci si connette a un PC, la stringa è:

rdp://full%20address=s:mypc:3389&audiomode=i:2&disable%20themes=i:1

Questa tabella contiene un elenco completo degli attributi supportati che possono essere usati con i client Desktop remoto su iOS, Mac, e Android. Una "x" nella colonna relativa alla piattaforma indica che l'attributo è supportato. I valori indicati da virgolette acute (<>) rappresentano i valori supportati dai client Desktop remoto.

Attributo RDP Android Mac iOS
allow desktop composition=i:<0 o 1> interno x interno
allow font smoothing=i:<0 o 1> interno x interno
alternate shell=s:<string> interno x interno
audiomode=i:<0, 1 o 2> interno x interno
authentication level=i:<0 o 1> interno x interno
connect to console=i:<0 o 1> interno x interno
disable cursor settings=i:<0 o 1> interno x interno
disable full window drag=i:<0 or 1> interno x interno
disable menu anims=i:<0 o 1> interno x interno
disable themes=i:<0 o 1> interno x interno
disable wallpaper=i:<0 o 1> interno x interno
drivestoredirect = s: * (questo è l'unico valore supportato) interno interno
desktopheight=i:<valore in pixel> x
desktopwidth=i:<valore in pixel> x
domain=s:<stringa> interno x interno
full address=s:<stringa> interno x interno
gatewayhostname=s:<stringa> interno x interno
gatewayusagemethod=i:<1 o 2> interno x interno
prompt for credentials on client=i:<0 o 1> x
loadbalanceinfo=s:<stringa> interno x interno
redirectprinters=i:<0 o 1> x
remoteapplicationcmdline=s:<stringa> interno x interno
remoteapplicationmode=i:<0 o 1> interno x interno
remoteapplicationprogram=s:<stringa> interno x interno
shell working directory=s:<stringa> interno x interno
Use redirection server name=i:<0 o 1> interno x interno
username=s:<stringa> interno x interno
screen mode id=i:<1 o 2> x
session bpp=i:<8, 15, 16, 24 o 32> x
use multimon=i:<0 o 1> x