Esquema de URI de Área de Trabalho Remota
Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows 11, Windows 10
Este documento define o formato de URIs (Uniform Resource Identifiers) para a Área de Trabalho Remota. Esses esquemas de URI permitem que os clientes da Área de Trabalho Remota sejam invocados com vários comandos.
Esquema de URI ms-rd
Observação
No momento, o esquema de URI ms-rd somente é compatível com o cliente da Área de Trabalho do Windows (MSRDC).
O URI ms-rd fornece a opção de especificar um comando para o cliente e um conjunto de parâmetros específicos para o comando usando o seguinte formato:
ms-rd:command?parameters
Os parâmetros usam o formato de cadeia de caracteres de consulta do par chave-valor separado por & para fornecer informações adicionais para o comando dado:
param1=value1¶m2=value2&…
Comandos e parâmetros
Aqui está a lista de comandos atualmente com suporte e dos parâmetros correspondentes.
Usar ms-rd: sem nenhum comando inicia o cliente.
Subscribe
Esse comando inicia o cliente e o processo de assinatura.
Nome do comando: subscribe
Parâmetros do comando:
| Parâmetro | Descrição | Valores |
|---|---|---|
| url | Especifica a URL do workspace. | Uma URL válida, como https://contoso.com. |
Exemplo: ms-rd:subscribe?url=https://contoso.com
Esquema de URI rdp herdado
Observação
O esquema de URI a seguir só é compatível com os clientes dos dispositivos macOS, iOS e Android. Ele está sendo substituído pelo novo URI ms-rd acima.
A Área de Trabalho Remota da Microsoft usa o esquema de URI rdp://query_string para armazenar configurações de atributos predefinidas que são usadas ao iniciar o cliente. As cadeias de caracteres de consulta representam um único ou um conjunto de atributos do RDP fornecidos na URL.
Os atributos RDP são separados pelo símbolo de e comercial (&). Por exemplo, ao se conectar a um computador, a cadeia de caracteres é:
rdp://full%20address=s:mypc:3389&audiomode=i:2&disable%20themes=i:1
Esta tabela fornece uma lista completa de atributos com suporte que podem ser usados com os clientes de Área de Trabalho Remota do iOS, Mac e Android. (Um "x" na coluna de plataforma indica que há suporte para o atributo. Os valores indicados por divisas (<>) representam os valores compatíveis com os clientes de Área de Trabalho Remota).
| Atributo RDP | Android | Mac | iOS |
|---|---|---|---|
| allow desktop composition=i:<0 ou 1> | x | x | x |
| allow font smoothing=i:<0 or 1> | x | x | x |
| alternate shell=s:<string> | x | x | x |
| audiomode=i:<0, 1, ou 2> | x | x | x |
| authentication level=i:<0 ou 1> | x | x | x |
| connect to console=i:<0 or 1> | x | x | x |
| disable cursor settings=i:<0 ou 1> | x | x | x |
| disable full window drag=i:<0 ou 1> | x | x | x |
| disable menu anims=i:<0 ou 1> | x | x | x |
| disable themes=i:<0 ou 1> | x | x | x |
| disable wallpaper=i:<0 ou 1> | x | x | x |
| drivestoredirect=s:* (esse é o único valor com suporte) | x | x | |
| desktopheight=i:<valor em pixels> | x | ||
| desktopwidth=i:<valor em pixels> | x | ||
| domain=s:<string> | x | x | x |
| full address=s:<string> | x | x | x |
| gatewayhostname=s:<string> | x | x | x |
| gatewayusagemethod=i:<1 ou 2> | x | x | x |
| prompt for credentials on client=i:<0 ou 1> | x | ||
| loadbalanceinfo=s:<string> | x | x | x |
| redirectprinters=i:<0 ou 1> | x | ||
| remoteapplicationcmdline=s:<string> | x | x | x |
| remoteapplicationmode=i:<0 ou 1> | x | x | x |
| remoteapplicationprogram=s:<string> | x | x | x |
| shell working directory=s:<string> | x | x | x |
| Use redirection server name=i:<0 ou 1> | x | x | x |
| username=s:<string> | x | x | x |
| screen mode id=i:<1 ou 2> | x | ||
| session bpp=i:<8, 15, 16, 24 ou 32> | x | ||
| use multimon=i:<0 ou 1> | x |