Esquemas de identificador uniforme de recursos con el cliente de Escritorio remoto para Azure Virtual Desktop
Puede usar esquemas de identificador uniforme de recursos (URI) para invocar el cliente de Escritorio remoto con comandos, parámetros y valores específicos para su uso con Azure Virtual Desktop. Por ejemplo, puede suscribirse a un área de trabajo o conectarse a un escritorio determinado o a una RemoteApp.
En este artículo se detallan los comandos y parámetros disponibles, junto con algunos ejemplos.
Clientes compatibles
En la siguiente tabla se enumeran los clientes admitidos para su uso con los esquemas de URI:
| Remoto | Versión |
|---|---|
| Cliente de Escritorio remoto para Windows | 1.2.4065 y versiones posteriores |
Esquemas de URI disponibles
Hay dos esquemas de URI para clientes de Escritorio remoto compatibles, ms-avd y ms-rd. Con ms-avd, puede especificar un recurso Azure Virtual Desktop concreto y un usuario con el que conectarse. Con ms-rd, puede suscribirse automáticamente a un área de trabajo en el cliente de Escritorio remoto, en lugar de tener que agregar manualmente el área de trabajo.
En las siguientes secciones se detallan los comandos y parámetros que puede usar con cada esquema de URI.
ms-avd
El esquema de identificador uniforme de recursos ms-avd para Azure Virtual Desktop se encuentra actualmente disponible con carácter general. Esta es la lista de comandos actualmente compatibles con ms-avd y sus parámetros correspondientes.
ms-avd:connect
ms-avd:connect busca un recurso de Azure Virtual Desktop especificado e inicia la sesión RDP, conectando directamente un usuario especificado a ese recurso.
Nombre del comando: connect
Parámetros del comando:
| Parámetro | Valores | Descripción |
|---|---|---|
| WorkspaceID | Id. de objeto (GUID). | Especifique el identificador de objeto de un área de trabajo válida. Para obtener el valor del identificador de objeto mediante PowerShell, consulte Recuperar el identificador de objeto de un grupo de hosts, un área de trabajo, un grupo de aplicaciones o una aplicación. También puede usar las API REST de Desktop Virtualization. |
| resourceid | Id. de objeto (GUID). | Especifique el identificador de objeto de un recurso publicado incluido en el área de trabajo. El valor puede ser para un escritorio o una RemoteApp. Para obtener el valor del identificador de objeto mediante PowerShell, consulte Recuperar el identificador de objeto de un grupo de hosts, un área de trabajo, un grupo de aplicaciones o una aplicación. También puede usar las API REST de Desktop Virtualization. |
| usuario | Nombre principal de usuario (UPN), por ejemplo user@contoso.com. |
Especifique un usuario válido con acceso al recurso especificado. |
| env (opcional) | avdarm (Azure comercial) avdgov (Azure Government) |
Especifique la nube de Azure donde se encuentran los recursos. |
| version | 0 | Especifique la versión del esquema de URI de la conexión que se va a usar. |
| launchpartnerid (opcional) | GUID. | Especifique el identificador proporcionado por el asociado o el cliente que puede usar con Diagnósticos de Azure Virtual Desktop para ayudarle a solucionar problemas. Se recomienda usar un GUID, que puede generar con el cmdlet de PowerShell New-Guid. |
| peeractivityid (opcional) | GUID. | Especifique el identificador proporcionado por el asociado o el cliente que puede usar con Diagnósticos de Azure Virtual Desktop para ayudarle a solucionar problemas. Se recomienda usar un GUID, que puede generar con el cmdlet de PowerShell New-Guid. |
Ejemplo:
ms-avd:connect?workspaceId=1638e073-63b2-46d8-bd84-ea02ea905467&resourceid=c2f5facc-196f-46af-991e-a90f3252c185&username=user@contoso.com&version=0
ms-rd
Esta es la lista de comandos actualmente admitidos para ms-rd y sus parámetros correspondientes.
Sugerencia
El uso de ms-rd: sin ningún comando inicia el cliente de Escritorio Remoto.
ms-rd:subscribe
ms-rd:subscribe inicia el cliente de Escritorio Remoto e inicia el proceso de suscripción.
Nombre del comando: subscribe
Parámetros del comando:
| Parámetro | Valores | Descripción |
|---|---|---|
| url | Una dirección URL válida, por ejemplo: https://rdweb.wvd.microsoft.com. | Especifique una dirección URL del área de trabajo. |
Ejemplo:
ms-rd:subscribe?url=https://rdweb.wvd.microsoft.com
Limitaciones conocidas
Estas son las limitaciones conocidas con los esquemas de URI:
- Las propiedades de visualización no se pueden configurar a través de URI. Puede configurar las propiedades de visualización como administrador en un grupo de hosts o los usuarios finales pueden configurar las propiedades de visualización en el cliente Azure Virtual Desktop.
Pasos siguientes
Obtenga información sobre Conectarse a Azure Virtual Desktop con el cliente de Escritorio remoto para Windows.