Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Pode utilizar esquemas de Uniform Resource Identifier (URI) para invocar o cliente de Ambiente de Trabalho Remoto com comandos, parâmetros e valores específicos para utilização com o Azure Virtual Desktop. Por exemplo, pode subscrever uma área de trabalho ou ligar a um ambiente de trabalho específico ou RemoteApp.
Este artigo detalha os comandos e parâmetros disponíveis, juntamente com alguns exemplos.
Clientes com suporte
A tabela seguinte lista os clientes suportados para utilização com os esquemas URI:
| Cliente | Versão |
|---|---|
| Cliente de Ambiente de Trabalho Remoto para Windows | 1.2.4065 e posterior |
|
Windows App para Windows apenas ms-avd |
2.0.804.0 e posterior |
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, pode especificar um determinado Azure recurso e utilizador do Virtual Desktop com o qual ligar. 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 secções seguintes detalham os comandos e parâmetros que pode utilizar com cada esquema de URI.
ms-avd
O esquema ms-avd Uniform Resource Identifier para Azure Virtual Desktop está agora disponível em geral. Eis a lista de comandos atualmente suportados para ms-avd e os respetivos parâmetros correspondentes.
Importante
Se o cliente de Ambiente de Trabalho Remoto e Windows App versão 2.0.804.0 ou superior estiverem instalados num dispositivo, o protocolo ms-avd iniciará uma Windows App.
ms-avd:connect
ms-avd:connectlocaliza um Azure recurso do Virtual Desktop especificado e inicia a sessão RDP, ligando diretamente um utilizador especificado a esse recurso.
Nome do comando: ligar
Parâmetros de comando:
| Parâmetro | Valores | Descrição |
|---|---|---|
| workspaceid | ID do Objeto (GUID). | Especifique o ID de objeto de uma área de trabalho válida. Para obter o valor do ID do objeto com o PowerShell, veja Obter o ID de objeto de um conjunto de anfitriões, área de trabalho, grupo de aplicações ou aplicação. Também pode utilizar as APIs REST de Virtualização de Ambiente de Trabalho. Necessário no cliente de Ambiente de Trabalho Remoto Não suportado no Windows App |
| resourceid | ID do Objeto (GUID). | Especifique o ID de objeto de um recurso publicado contido na área de trabalho. O valor pode ser para um ambiente de trabalho ou RemoteApp. Para obter o valor do ID do objeto com o PowerShell, veja Obter o ID de objeto de um conjunto de anfitriões, área de trabalho, grupo de aplicações ou aplicação. Também pode utilizar as APIs REST de Virtualização de Ambiente de Trabalho. Necessário no cliente de Ambiente de Trabalho Remoto e Windows App |
| usuário | Nome Principal de Utilizador (UPN), por exemplo user@contoso.com. |
Especifique um utilizador válido com acesso ao recurso especificado. Necessário no cliente de Ambiente de Trabalho Remoto e Windows App |
| env |
avdarm (Azure comercial) usgov (Azure Governamental) |
Especifique o Azure cloud onde estão localizados os recursos. Opcional no cliente de Ambiente de Trabalho Remoto Não suportado no Windows App. |
| versão | 0 | Especifique a versão do esquema URI de ligação a utilizar. Necessário no cliente de Ambiente de Trabalho Remoto Não suportado no Windows App. |
| launchpartnerid | GUID. | Especifique o ID fornecido pelo parceiro ou pelo cliente que pode utilizar com o Azure Diagnóstico do Virtual Desktop para ajudar na resolução de problemas. Recomendamos a utilização de um GUID, que pode gerar com o cmdlet do PowerShell New-Guid . Opcional no cliente de Ambiente de Trabalho Remoto Não suportado no Windows App. |
| peeractivityid | GUID. | Especifique o ID fornecido pelo parceiro ou pelo cliente que pode utilizar com o Azure Diagnóstico do Virtual Desktop para ajudar na resolução de problemas. Recomendamos a utilização de um GUID, que pode gerar com o cmdlet do PowerShell New-Guid . Opcional no cliente de Ambiente de Trabalho Remoto Não suportado no Windows App. |
| usemultimon | verdadeiro ou falso | Especifique se a sessão remota irá utilizar um ou vários ecrãs do computador local. Opcional no cliente de Ambiente de Trabalho Remoto e Windows App |
Exemplo:
ms-avd:connect?workspaceId=1638e073-63b2-46d8-bd84-ea02ea905467&resourceid=a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1&username=user@contoso.com&version=0
ms-rd
Eis a lista de comandos atualmente suportados para ms-rd e os respetivos parâmetros correspondentes.
Dica
A utilização ms-rd: sem comandos inicia o cliente de Ambiente de Trabalho Remoto.
ms-rd:subscrever
ms-rd:subscribe inicia o cliente de Ambiente de Trabalho Remoto e inicia o processo de subscrição.
Nome do comando: subscrever
Parâmetros de comando:
| Parâmetro | Valores | Descrição |
|---|---|---|
| url | Um URL válido, como https://rdweb.wvd.microsoft.com. | Especifique um URL da área de trabalho. |
Exemplo:
ms-rd:subscribe?url=https://rdweb.wvd.microsoft.com
Limitações Conhecidas
Seguem-se limitações conhecidas com os esquemas de URI:
- Não é possível configurar as propriedades de apresentação através do URI. Pode configurar as propriedades de apresentação como administrador num conjunto de anfitriões ou os utilizadores finais podem configurar propriedades de apresentação no cliente do Azure Virtual Desktop.
Próximas etapas
Saiba como Ligar ao Azure Virtual Desktop com o cliente de Ambiente de Trabalho Remoto para Windows.