Compartir a través de

Esquema de URI de Escritorio remoto

  • Artículo

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows 11, Windows 10

En este documento se define el formato de los identificadores uniformes de recursos (URI) para Escritorio remoto. Estos esquemas de URI permiten invocar a los clientes de Escritorio remoto con varios comandos.

Esquema de URI ms-rd

Nota

El esquema de URI ms-rd solo se admite actualmente con el cliente de Escritorio de Windows (MSRDC).

El URI de ms-rd ofrece la opción de especificar un comando para el cliente y un conjunto de parámetros específicos del comando con el siguiente formato:

ms-rd:command?parameters

Los parámetros usan el formato de cadena de consulta de par clave=valor, separado por & para ofrecer información adicional para el comando dado:

param1=value1&param2=value2&…

Comandos y parámetros

Esta es la lista de comandos admitidos actualmente y sus parámetros correspondientes.

El uso de ms-rd: sin ningún comando inicia el cliente.

Subscribe

Este comando inicia el cliente e inicia el proceso de suscripción.

Nombre del comando: subscribe

Parámetros del comando:

Parámetro Descripción Valores
url Especifica la dirección URL del área de trabajo. Una dirección URL válida, por ejemplo: https://contoso.com.

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

Esquema de URI rdp heredado

Nota

El siguiente esquema de URI solo es compatible con los clientes de dispositivos macOS, iOS y Android. Se está reemplazando por el nuevo URI de ms-rd anterior.

Escritorio remoto de Microsoft usa el esquema de URI rdp://query_string para almacenar la configuración de atributos preconfigurados que se usa al iniciar el cliente. Las cadenas de consulta representan un único atributo o un conjunto de atributos RDP que se proporcionan en la dirección URL.

Los atributos RDP se separan mediante el símbolo de "y" comercial (&). Por ejemplo, al conectarse a un equipo, la cadena es:

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

Esta tabla proporciona una lista completa de los atributos compatibles que pueden usarse con clientes de Escritorio remoto de iOS, Mac y Android. (Una "x" en la columna de plataforma indica que el atributo es compatible. Los valores indicados por comillas angulares (<>) representan los valores que son compatibles con los clientes de Escritorio remoto).

Atributo RDP Android Mac iOS
allow desktop composition=i:<0 o 1> x x x
allow font smoothing=i:<0 o 1> x x x
alternate shell=s:<cadena> x x x
audiomode=i:<0, 1 o 2> x x x
authentication level=i:<0 o 1> x x x
connect to console=i:<0 o 1> x x x
disable cursor settings=i:<0 o 1> x x x
disable full window drag=i:<0 o 1> x x x
disable menu anims=i:<0 o 1> x x x
disable themes=i:<0 o 1> x x x
disable wallpaper=i:<0 o 1> x x x
drivestoredirect = s: * (este es el único valor admitido) x x
desktopheight=i:<valor en píxeles> x
desktopwidth=i:<valor en píxeles> x
domain=s:<cadena> x x x
full address=s:<cadena> x x x
gatewayhostname=s:<string> x x x
gatewayusagemethod=i:<1 o 2> x x x
prompt for credentials on client=i:<0 o 1> x
loadbalanceinfo=s:<string> x x x
redirectprinters=i:<0 o 1> x
remoteapplicationcmdline=s:<string> x x x
remoteapplicationmode=i:<0 o 1> x x x
remoteapplicationprogram=s:<cadena> x x x
shell working directory=s:<cadena> x x x
Use redirection server name=i:<0 o 1> x x x
username=s:<cadena> x x x
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