Esquemas de Uniform Resource Identifier com o cliente da Área de Trabalho Remota para a Área de Trabalho Virtual do Azure

Você pode usar esquemas de URI (Uniform Resource Identifier) para invocar o cliente da Á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 assinar um espaço de trabalho ou se conectar a uma área de trabalho específica ou RemoteApp.

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

Clientes com suporte

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

Cliente Versão
Cliente da Área de Trabalho Remota para Windows 1.2.4065 e posterior

Esquemas de URI disponíveis

Há dois esquemas de URI para clientes de Área de Trabalho Remota com suporte, ms-avd e ms-rd. Com o ms-avd, você pode especificar um recurso específico da Área de Trabalho Virtual do Azure e um usuário com o qual se conectar. Com o ms-rd, você pode assinar automaticamente um workspace no cliente da Área de Trabalho Remota, em vez de precisar adicionar manualmente o workspace.

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

ms-avd

O esquema de Uniform Resource Identifier ms-avd para a Área de Trabalho Virtual do Azure está em disponibilidade geral. Aqui está a lista de comandos atualmente suportados para ms-avd e seus parâmetros correspondentes.

ms-avd:connect

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

Nome do comando: conectar

Parâmetros do comando:

Parâmetro Valores Descrição
WorkspaceID ID do objeto (GUID). Especifique a ID do objeto de um workspace válido.

Para obter o valor da ID do objeto usando o PowerShell, confira Recuperar a ID do objeto de um pool de host, workspace, grupo de aplicativos ou aplicativo. Você também pode usar APIs REST de Virtualização de Área de Trabalho.
resourceid ID do objeto (GUID). Especifique a ID do objeto de um recurso publicado contido no workspace. O valor pode ser para uma área de trabalho ou um RemoteApp.

Para obter o valor da ID do objeto usando o PowerShell, confira Recuperar a ID do objeto de um pool de host, workspace, grupo de aplicativos ou aplicativo. Você também pode usar APIs REST de Virtualização de Área de Trabalho.
usuário Nome UPN (Nome Principal do Usuário), por exemplo user@contoso.com. Especifique um usuário válido com acesso ao recurso especificado.
env (opcional) avdarm (Azure comercial)
avdgov (Azure Governamental)
Especifique a nuvem do Azure onde os recursos estão localizados.
version 0 Especifique a versão do esquema de URI de conexão a ser usado.
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. É recomendável usar um GUID, que você pode gerar com o cmdlet New-Guid do 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. É recomendável usar um GUID, que você pode gerar com o cmdlet New-Guid do PowerShell.
usemultimon true ou false Especifique se a sessão remota usará uma ou várias exibições 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.

Dica

Usar ms-rd: sem nenhum comando inicia o cliente da Área de Trabalho Remota.

ms-rd:subscribe

ms-rd:subscribe inicia o cliente da Área de Trabalho Remota e inicia o processo de assinatura.

Nome do comando: subscribe

Parâmetros do comando:

Parâmetro Valores Descrição
url Uma URL válida, como https://rdweb.wvd.microsoft.com. Especifique um URL do workspace.

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:

Próximas etapas

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