Establecimiento de propiedades personalizadas del Protocolo de Escritorio remoto (RDP) en un grupo de hosts en Azure Virtual Desktop

Cuando los usuarios inician sesión en Windows App o la aplicación escritorio remoto, se muestran los escritorios y las aplicaciones a las que tienen acceso. Para cada escritorio y aplicación, hay un archivo correspondiente .rdp que contiene todas las propiedades de conexión que se deben usar al conectarse a una sesión remota a través del Protocolo de Escritorio remoto (RDP). Estas propiedades RDP se establecen por grupo de hosts.

Cada grupo de hosts tiene un conjunto de propiedades y valores de RDP predeterminados. Puede agregar otras propiedades al conjunto predeterminado o invalidar los valores predeterminados estableciendo propiedades rdp personalizadas. En este artículo se muestra cómo establecer propiedades de RDP personalizadas en un grupo de hosts mediante el Azure Portal, Azure PowerShell y la CLI de Azure.

Propiedades de RDP predeterminadas del grupo de hosts

De forma predeterminada, los grupos de hosts tienen las siguientes propiedades y valores de RDP:

RDP (propiedad)	Detalles
audiomode:i:0	Determina si la máquina local o remota reproduce audio.
devicestoredirect:s:*	Determina qué periféricos que usan el Protocolo de transferencia de medios (MTP) o el Protocolo de transferencia de imágenes (PTP), como una cámara digital, se redirigen desde un dispositivo Windows local a una sesión remota.
drivestoredirect:s:*	Determina qué unidades fijas, extraíbles y de red en el dispositivo local se redirigirán y estarán disponibles en una sesión remota.
enablecredsspsupport:i:1	Determina si el cliente usará el proveedor de soporte técnico de seguridad de credenciales (CredSSP) para la autenticación si está disponible.
redirectclipboard:i:1	Determina si se redirige el Portapapeles.
redirectcomports:i:1	Determina si los puertos COM o serie del dispositivo local se redirigen a una sesión remota.
redirectprinters:i:1	Determina si las impresoras disponibles en el dispositivo local se redirigen a una sesión remota.
redirectsmartcards:i:1	Determina si los dispositivos de tarjeta inteligente del dispositivo local se redirigirán y estarán disponibles en una sesión remota.
redirectwebauthn:i:1	Determina si las solicitudes webAuthn de una sesión remota se redirigen al dispositivo local, lo que permite el uso de autenticadores locales (como Windows Hello para empresas y claves de seguridad).
usbdevicestoredirect:s:*	Determina qué dispositivos USB compatibles en el equipo cliente se redirigen mediante el redireccionamiento opaco de bajo nivel a una sesión remota.
use multimon:i:1	Determina si la sesión remota usará una o varias pantallas del dispositivo local.
videoplaybackmode:i:1	Determina si la conexión usará streaming multimedia eficaz de RDP para la reproducción de vídeo.

Para obtener una lista completa de propiedades y valores admitidos, consulte Propiedades de RDP compatibles con Azure Virtual Desktop.

Sugerencia

Para más información sobre cómo redirigir periféricos y recursos, consulte Periféricos y redireccionamiento de recursos a través del Protocolo de Escritorio remoto. Es posible que tenga que configurar algo más que una propiedad RDP.

Requisitos previos

Para poder establecer propiedades de RDP personalizadas en un grupo de hosts, necesita:

• Un grupo de hosts existente.

• Una cuenta de Azure a la que se asignó el rol colaborador del grupo de hosts de virtualización de escritorio o equivalente.

• Si desea usar la CLI de Azure o Azure PowerShell localmente, consulte Uso de la CLI de Azure y Azure PowerShell con Azure Virtual Desktop para asegurarse de que tiene instalada la extensión de la CLI de Azure desktopvirtualization o el módulo Az.DesktopVirtualization de PowerShell. Como alternativa, use azure Cloud Shell.

Configuración de propiedades de RDP personalizadas

Seleccione la pestaña correspondiente para el escenario.

Portal de Azure

Aquí se muestra cómo configurar las propiedades de RDP mediante el Azure Portal. Para obtener una lista completa de propiedades y valores admitidos, consulte Propiedades de RDP compatibles con Azure Virtual Desktop.

1. Inicie sesión en el portal de Azure.

2. En la barra de búsqueda, escriba Azure Virtual Desktop y seleccione la entrada de servicio coincidente.

3. Seleccione Grupos de hosts y, a continuación, seleccione el nombre del grupo de hosts que desea actualizar.

4. Seleccione Propiedades de RDP y, a continuación, seleccione la pestaña Opciones avanzadas .

   

5. Agregue propiedades RDP adicionales o realice cambios en las propiedades de RDP existentes en un formato separado por punto y coma, como los valores predeterminados que ya se muestran.

6. Cuando haya terminado, seleccione Guardar para guardar los cambios. Los usuarios deben actualizar sus recursos para recibir los cambios.

Azure PowerShell

Para configurar las propiedades de RDP mediante Azure PowerShell, use los ejemplos siguientes. Asegúrese de cambiar los <placeholder> valores de los suyos propios. Para obtener una lista completa de propiedades y valores admitidos, consulte Propiedades de RDP compatibles con Azure Virtual Desktop.

1. Abra Azure Cloud Shell en el Azure Portal con el tipo de terminal de PowerShell o ejecute PowerShell en el dispositivo local.

   • Si usa Cloud Shell, asegúrese de que el contexto de Azure está establecido en la suscripción que desea usar.

   • Si usa PowerShell localmente, inicie sesión primero con Azure PowerShell y, a continuación, asegúrese de que el contexto de Azure está establecido en la suscripción que desea usar.

2. Use uno de los ejemplos siguientes en función de sus requisitos:

   • Para agregar propiedades de RDP personalizadas a un grupo de hosts y mantener las propiedades personalizadas existentes ya establecidas, ejecute los siguientes comandos. Las propiedades RDP deben escribirse en un formato separado por puntos y comas. En este ejemplo se agrega la deshabilitación del Portapapeles y el redireccionamiento de la impresora:

     $hostPool = "<HostPoolName>"
     $resourceGroup = "<ResourceGroupName>"
     $addCustomProperties = "redirectclipboard:i:0;redirectprinters:i:0"
     
     $currentCustomProperties = (Get-AzWvdHostPool -Name $hostPool -ResourceGroupName $resourceGroup).CustomRdpProperty
     $customProperties = $currentCustomProperties + $addCustomProperties
     
     Update-AzWvdHostPool -Name $hostPool -ResourceGroupName $resourceGroup -CustomRdpProperty $customProperties
     

   • Para reemplazar todas las propiedades personalizadas existentes por un nuevo conjunto de propiedades de RDP personalizadas, ejecute el siguiente comando. En este ejemplo solo se establece la deshabilitación del portapapeles y el redireccionamiento de impresoras:

     $hostPool = "<HostPoolName>"
     $resourceGroup = "<ResourceGroupName>"
     $customProperties = "redirectclipboard:i:0;redirectprinters:i:0"
     
     Update-AzWvdHostPool -Name $hostPool -ResourceGroupName $resourceGroup -CustomRdpProperty $customProperties
     

   • Para quitar todas las propiedades de RDP personalizadas de un grupo de hosts, ejecute el siguiente comando. En este ejemplo se pasa una cadena vacía al CustomRdpProperty parámetro :

     $hostPool = "<HostPoolName>"
     $resourceGroup = "<ResourceGroupName>"
     $customProperties = ""
     
     Update-AzWvdHostPool -Name $hostPool -ResourceGroupName $resourceGroup -CustomRdpProperty $customProperties
     

3. Para comprobar las propiedades de RDP personalizadas establecidas en el mismo grupo host, ejecute el siguiente comando:

   Get-AzWvdHostPool -Name $hostPool -ResourceGroupName $resourceGroup | FT Name, CustomRdpProperty
   

   La salida debe ser similar al ejemplo siguiente:

    Name              : contoso-hp01
    CustomRdpProperty : use multimon:i:1;redirectclipboard:i:0;redirectprinters:i:0;
   

4. Los usuarios deben actualizar sus recursos para recibir los cambios.

Azure CLI

Para configurar las propiedades de RDP mediante la CLI de Azure, use los ejemplos siguientes. Asegúrese de cambiar los <placeholder> valores de los suyos propios. Para obtener una lista completa de propiedades y valores admitidos, consulte Propiedades de RDP compatibles con Azure Virtual Desktop.

1. Abra Azure Cloud Shell en el Azure Portal con el tipo de terminal bash o ejecute la CLI de Azure en el dispositivo local.

   • Si usa Cloud Shell, asegúrese de que el contexto de Azure está establecido en la suscripción que desea usar.

   • Si usa la CLI de Azure localmente, inicie sesión primero con la CLI de Azure y, a continuación, asegúrese de que el contexto de Azure está establecido en la suscripción que desea usar.

2. Use uno de los ejemplos siguientes en función de sus requisitos:

   • Para agregar propiedades de RDP personalizadas a un grupo de hosts y mantener las propiedades personalizadas existentes ya establecidas, ejecute los siguientes comandos. Las propiedades RDP deben escribirse en un formato separado por puntos y comas. En este ejemplo se agrega la deshabilitación del portapapeles y el redireccionamiento de impresora a las propiedades personalizadas existentes:

     hostPool="<HostPoolName>"
     resourceGroup="<ResourceGroupName>"
     addCustomProperties="redirectclipboard:i:0;redirectprinters:i:0"
     
     currentCustomProperties=$(az desktopvirtualization hostpool show \
          --name $hostPool \
          --resource-group $resourceGroup \
          --query [customRdpProperty] \
          --output tsv)
     
     customProperties="$currentCustomProperties$addCustomProperties"
     
     az desktopvirtualization hostpool update \
          --name $hostPool \
          --resource-group $resourceGroup \
          --custom-rdp-property "$customProperties"
     

   • Para reemplazar todas las propiedades personalizadas existentes por un nuevo conjunto de propiedades de RDP personalizadas, ejecute el siguiente comando. En este ejemplo solo se establece la deshabilitación del portapapeles y el redireccionamiento de impresoras:

     hostPool="<HostPoolName>"
     resourceGroup="<ResourceGroupName>"
     
     az desktopvirtualization hostpool update \
          --name $hostPool \
          --resource-group $resourceGroup \
          --custom-rdp-property "redirectclipboard:i:0;redirectprinters:i:0"
     

   • Para quitar todas las propiedades de RDP personalizadas de un grupo de hosts, ejecute el siguiente comando. En este ejemplo se pasa una cadena vacía al --custom-rdp-property parámetro :

     hostPool="<HostPoolName>"
     resourceGroup="<ResourceGroupName>"
     
     az desktopvirtualization hostpool update \
          --name $hostPool \
          --resource-group $resourceGroup \
          --custom-rdp-property ""
     

3. Para comprobar las propiedades de RDP personalizadas establecidas en el mismo grupo host, ejecute el siguiente comando:

   az desktopvirtualization hostpool show \
       --name $hostPool \
       --resource-group $resourceGroup \
       --query "{name:name, customRdpProperty:customRdpProperty}" \
       --output table
   

   La salida debe ser similar al ejemplo siguiente:

   Name          CustomRdpProperty
   --------      ------------------------------------------------------------
   contoso-hp01  use multimon:i:0;redirectclipboard:i:0;redirectprinters:i:0;
   

4. Los usuarios deben actualizar sus recursos para recibir los cambios.

Contenido relacionado

• Propiedades de RDP admitidas con Azure Virtual Desktop
• Redirección de periféricos y recursos a través del protocolo de Escritorio remoto