Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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 o RemoteApp determinados.
En este artículo se detallan los comandos y parámetros disponibles, junto con algunos ejemplos.
Clientes compatibles
En la tabla siguiente se enumeran los clientes admitidos para su uso con los esquemas uri:
| Cliente | Versión |
|---|---|
| Cliente de Escritorio remoto para Windows | 1.2.4065 y versiones posteriores |
|
Windows App para Windows solo ms-avd |
2.0.804.0 y versiones posteriores |
Esquemas de URI disponibles
Hay dos esquemas URI para los clientes de Escritorio remoto admitidos, ms-avd y ms-rd. Con ms-avd, puede especificar un determinado Azure recurso y usuario de Virtual Desktop 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 secciones siguientes se detallan los comandos y parámetros que puede usar con cada esquema de URI.
ms-avd
El esquema de identificador uniforme de recursos de ms-avd para Azure Virtual Desktop ya está disponible con carácter general. Esta es la lista de comandos admitidos actualmente para ms-avd y sus parámetros correspondientes.
Importante
Si tanto el cliente de Escritorio remoto como Windows App versión 2.0.804.0 o posterior están instalados en un dispositivo, el protocolo ms-avd iniciará una Windows App.
ms-avd:connect
ms-avd:connectbusca un Azure recurso de Virtual Desktop especificado e inicia la sesión RDP, conectando directamente a un usuario especificado a ese recurso.
Nombre del comando: connect
Parámetros de 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 Recuperación del 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 virtualización de escritorio. Requerido en el cliente de Escritorio remoto No se admite en Windows App |
| resourceid | Id. de objeto (GUID). | Especifique el identificador de objeto de un recurso publicado contenido en el área de trabajo. El valor puede ser para un escritorio o RemoteApp. Para obtener el valor del identificador de objeto mediante PowerShell, consulte Recuperación del 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 virtualización de escritorio. Requerido en el cliente de Escritorio remoto y Windows App |
| usuario | Nombre principal de usuario (UPN), por ejemplo user@contoso.com. |
Especifique un usuario válido con acceso al recurso especificado. Requerido en el cliente de Escritorio remoto y Windows App |
| Env |
avdarm (Azure comercial) usgov (Azure Government) |
Especifique la nube Azure donde se encuentran los recursos. Opcional en el cliente de Escritorio remoto No se admite en Windows App. |
| version | 0 | Especifique la versión del esquema de URI de conexión que se va a usar. Requerido en el cliente de Escritorio remoto No se admite en Windows App. |
| launchpartnerid | GUID. | Especifique el identificador proporcionado por el asociado o por el cliente que puede usar con Azure Diagnóstico de Virtual Desktop para ayudar a solucionar problemas. Se recomienda usar un GUID, que puede generar con el cmdlet de PowerShell New-Guid . Opcional en el cliente de Escritorio remoto No se admite en Windows App. |
| peeractivityid | GUID. | Especifique el identificador proporcionado por el asociado o por el cliente que puede usar con Azure Diagnóstico de Virtual Desktop para ayudar a solucionar problemas. Se recomienda usar un GUID, que puede generar con el cmdlet de PowerShell New-Guid . Opcional en el cliente de Escritorio remoto No se admite en Windows App. |
| usemultimon | true o false | Especifique si la sesión remota usará una o varias pantallas del equipo local. Opcional en el cliente de Escritorio remoto y Windows App |
Ejemplo:
ms-avd:connect?workspaceId=1638e073-63b2-46d8-bd84-ea02ea905467&resourceid=a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1&username=user@contoso.com&version=0
ms-rd
Esta es la lista de comandos admitidos actualmente para ms-rd y sus parámetros correspondientes.
Sugerencia
El uso ms-rd: sin comandos 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 de comando:
| Parámetro | Valores | Descripción |
|---|---|---|
| url | Una dirección URL válida, como 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 host o los usuarios finales pueden configurar las propiedades de visualización en el cliente de Azure Virtual Desktop.
Pasos siguientes
Obtenga información sobre cómo conectarse a Azure Escritorio virtual con el cliente de Escritorio remoto para Windows.