Compartir a través de

Esquemas uniformes de identificador 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 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

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 recurso y un usuario de Azure Virtual Desktop concretos con los 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.

ms-avd:connect

ms-avd:connect busca un recurso de Azure 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.
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.
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)
usgov (Azure Government)		 Especifique la nube de Azure donde se encuentran los recursos.
version 0 Especifique la versión del esquema de URI de 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 ayudar 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 ayudar a solucionar problemas. Se recomienda usar un GUID, que puede generar con el cmdlet de PowerShell New-Guid .
usemultimon true o false Especifique si la sesión remota usará una o varias pantallas del equipo local.

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

Aprenda a conectarse a Azure Virtual Desktop con el cliente de Escritorio remoto para Windows.