Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
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 workspace ou conectar-se 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 |
|
aplicativo do Windows para Windows Somente MS-AVD |
2.0.804.0 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 espaço de trabalho no cliente de Área de Trabalho Remota, em vez de precisar adicionar manualmente o espaço 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 do Uniform Resource Identifier ms-avd para a Área de Trabalho Virtual do Azure já está em disponibilidade geral. Aqui está a lista de comandos atualmente suportados para ms-avd e seus parâmetros correspondentes.
Importante
Se o cliente da Área de Trabalho Remota e o aplicativo do aplicativo do Windows versão 2.0.804.0 ou superior estiverem instalados em um dispositivo, o protocolo ms-AVD iniciará um aplicativo do Windows.
ms-avd:connect
ms-avd:connectlocaliza 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 | Descrição |
|---|---|---|
| ID do workspace | ID do objeto (GUID). | Especifique a ID de objeto de um workspace válido. Para obter o valor da 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. Necessário no cliente de Área de Trabalho Remota Sem suporte no aplicativo do Windows |
| resourceid | ID do objeto (GUID). | Especifique a ID de objeto de um recurso publicado contido no workspace. O valor pode ser para uma área de trabalho ou RemoteApp. Para obter o valor da 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. Necessário no cliente de Área de Trabalho Remota e no aplicativo aplicativo do Windows |
| usuário | UPN, por exemplo user@contoso.com. |
Especifique um usuário válido com acesso ao recurso especificado. Necessário no cliente de Área de Trabalho Remota e no aplicativo aplicativo do Windows |
| Env |
avdarm (Azure comercial) usgov (Azure Governamental) |
Especifique a nuvem do Azure onde os recursos estão localizados. Opcional no cliente de Área de Trabalho Remota Sem suporte no aplicativo do Windows. |
| versão | 0 | Especifique a versão do esquema de URI de conexão a ser usado. Necessário no cliente de Área de Trabalho Remota Sem suporte no aplicativo do Windows. |
| LaunchPartnerID | 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 do PowerShell. Opcional no cliente de Área de Trabalho Remota Sem suporte no aplicativo do Windows. |
| peeractivityid | 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 do PowerShell. Opcional no cliente de Área de Trabalho Remota Sem suporte no aplicativo do Windows. |
| usemultimon | Verdadeira ou Falsa | Especifique se a sessão remota usará uma ou várias telas do computador local. Opcional no cliente de Área de Trabalho Remota e no aplicativo aplicativo do Windows |
Exemplo:
ms-avd:connect?workspaceId=1638e073-63b2-46d8-bd84-ea02ea905467&resourceid=a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1&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 de comando:
| Parâmetro | Valores | Descrição |
|---|---|---|
| url | Uma URL válida, como https://rdweb.wvd.microsoft.com. | Especifique uma URL do workspace. |
Exemplo:
ms-rd:subscribe?url=https://rdweb.wvd.microsoft.com
Limitações conhecidas
Aqui estão as limitações conhecidas dos esquemas de URI:
- As propriedades de exibição não podem ser configuradas via URI. Você pode configurar propriedades de exibição como um administrador em um pool de hosts 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 se conectar à Área de Trabalho Virtual do Azure com o cliente de Área de Trabalho Remota para Windows.