Compartir a través de


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.
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=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.