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:
- As propriedades de exibição não podem ser configuradas por meio do URI. Você pode configurar propriedades de exibição como um administrador em um pool de host ou os usuários finais podem configurar propriedades de exibição no cliente da Área de Trabalho Virtual do Azure.
Próximas etapas
Saiba como Conectar-se à Área de Trabalho Virtual do Azure usando o cliente da Área de Trabalho Remota para Windows.