Esquemas de Identificador Uniforme de Recursos com o cliente de Área de Trabalho Remota para Área de Trabalho Virtual do Azure

Você pode usar esquemas de URI (Uniform Resource Identifier) para invocar o cliente de Área de Trabalho Remota com comandos, parâmetros e valores específicos para uso com a Área de Trabalho Virtual do Azure. Por exemplo, você pode se inscrever em um espaço de trabalho ou conectar-se a uma área de trabalho ou RemoteApp específico.

Este artigo detalha os comandos e parâmetros disponíveis, juntamente com alguns exemplos.

Clientes suportados

A tabela a seguir lista os clientes suportados para uso com os esquemas de URI:

Cliente Versão
Cliente de Ambiente de Trabalho Remoto para Windows 1.2.4065 e seguintes

Esquemas de URI disponíveis

Existem dois esquemas de URI para clientes de Ambiente de Trabalho Remoto suportados, ms-avd e ms-rd. Com o ms-avd, você pode especificar um determinado recurso da Área de Trabalho Virtual do Azure e um usuário com o qual se conectar. Com o ms-rd, pode subscrever automaticamente uma área de trabalho no cliente de Ambiente de Trabalho Remoto, em vez de ter de adicionar manualmente a área de trabalho.

As seções a seguir detalham os comandos e parâmetros que você pode usar com cada esquema de URI.

MS-AVD

O esquema ms-avd Uniform Resource Identifier para a Área de Trabalho Virtual do Azure agora está disponível ao público em geral. Aqui está a lista de comandos atualmente suportados para ms-avd e seus parâmetros correspondentes.

ms-avd:conectar

ms-avd:connect localiza um recurso especificado da Área de Trabalho Virtual do Azure e inicia a sessão RDP, conectando diretamente um usuário especificado a esse recurso.

Nome do comando: connect

Parâmetros de comando:

Parâmetro Valores Description
WorkspaceID ID do objeto (GUID). Especifique a ID do objeto de um espaço de trabalho válido.

Para obter o valor de ID do objeto usando o PowerShell, consulte Recuperar a ID do objeto de um pool de hosts, espaço de trabalho, grupo de aplicativos ou aplicativo. Você também pode usar APIs REST do Desktop Virtualization.
ResourceID ID do objeto (GUID). Especifique a ID do objeto de um recurso publicado contido no espaço de trabalho. O valor pode ser para uma área de trabalho ou RemoteApp.

Para obter o valor de ID do objeto usando o PowerShell, consulte Recuperar a ID do objeto de um pool de hosts, espaço de trabalho, grupo de aplicativos ou aplicativo. Você também pode usar APIs REST do Desktop Virtualization.
Utilizador Nome Principal do Usuário (UPN), por exemplo user@contoso.com. Especifique um usuário válido com acesso ao recurso especificado.
env (opcional) avdarm (Azure comercial)
avdgov (Azure Government)
Especifique a nuvem do Azure onde os recursos estão localizados.
versão 0 Especifique a versão do esquema de URI de conexão a ser usada.
LaunchPartnerID (opcional) GUID. Especifique a ID fornecida pelo parceiro ou pelo cliente que você pode usar com o Diagnóstico da Área de Trabalho Virtual do Azure para ajudar na solução de problemas. Recomendamos o uso de um GUID, que você pode gerar com o cmdlet New-Guid PowerShell.
PeerActivityID (opcional) GUID. Especifique a ID fornecida pelo parceiro ou pelo cliente que você pode usar com o Diagnóstico da Área de Trabalho Virtual do Azure para ajudar na solução de problemas. Recomendamos o uso de um GUID, que você pode gerar com o cmdlet New-Guid PowerShell.
usemultimon verdadeiro ou falso Especifique se a sessão remota usará um ou vários monitores do computador local.

Exemplo:

ms-avd:connect?workspaceId=1638e073-63b2-46d8-bd84-ea02ea905467&resourceid=c2f5facc-196f-46af-991e-a90f3252c185&username=user@contoso.com&version=0

MS-RD

Aqui está a lista de comandos atualmente suportados para ms-rd e seus parâmetros correspondentes.

Gorjeta

O uso ms-rd: sem comandos inicia o cliente da Área de Trabalho Remota.

ms-rd:subscrever

ms-rd:subscribe inicia o cliente de Ambiente de Trabalho Remoto e inicia o processo de subscrição.

Nome do comando: subscribe

Parâmetros de comando:

Parâmetro Valores Description
url Um URL válido, como https://rdweb.wvd.microsoft.com. Especifique uma URL de espaço de trabalho.

Exemplo:

ms-rd:subscribe?url=https://rdweb.wvd.microsoft.com

Limitações Conhecidas

Aqui estão as limitações conhecidas com os esquemas de URI:

  • As propriedades de exibição não podem ser configuradas via URI. Você pode configurar propriedades de exibição como administrador em um pool de hosts ou os usuários finais podem configurar propriedades de exibição no cliente de Área de Trabalho Virtual do Azure.

Próximos passos

Saiba como Conectar-se à Área de Trabalho Virtual do Azure com o cliente de Área de Trabalho Remota para Windows.