Para configurar ciertas funciones de Horizon Client, puede utilizar los ajustes de la sección common-setting. La propiedad editable especifica la disponibilidad de la configuración que debe cambiar el usuario. Un asterisco en la siguiente tabla indica los ajustes que puede configurar en la lista editable.

Nota: Para asegurarse de que la configuración modificada surta efecto, los usuarios deberán reiniciar Horizon Client.
Configuración Descripción
editable Configura una lista de ajustes de Horizon Client y especifica si un usuario puede modificar ciertos ajustes comunes. En general, la directiva de cada servidor determina el valor de la configuración. Puede agregar cualquier función de cliente en esta tabla marcada con un asterisco (*).

Si el valor de un ajuste que aparece en la propiedad editable es false, ese ajuste no estará disponible. El usuario no puede cambiar esa configuración. La interfaz de usuario aparecerá en gris. Para realizar cambios, el administrador del sistema puede actualizar la directiva establecida por el servidor.

Si una opción está en la lista de la propiedad editable y se establece en true, esa opción estará disponible en la interfaz de usuario. El usuario puede realizar un cambio.

Nota: La primera vez que se use, el cliente aplicará cualquier configuración de la directiva del servidor. Después de eso, si la configuración se puede editar y el usuario la ha cambiado, el cliente utilizará esa configuración.
allowDataSharing* Configura la función de uso compartido de datos. Establezca el valor para habilitar o desactivar el uso compartido. Los valores válidos son true (habilitar) y false (desactivar).
allowFileDownload

Configura si los usuarios pueden descargar archivos desde un escritorio remoto al dispositivo cliente. Establezca el valor para habilitar o bloquear la descarga de archivos.

Los valores válidos son true (habilitar) y false (bloquear). El valor predeterminado es true.

Nota: Para habilitar la descarga de archivos con la función de transferencia de archivos, deberá habilitar allowFileDownload en el lado cliente y también establecer la opción del GPO Configurar la transferencia de archivos para permitir la descarga de archivos en el lado del agente. Consulte Funciones de escritorios remotos y GPO de Horizon.
allowFileUpload

Configura si los usuarios pueden cargar archivos a un escritorio remoto desde el dispositivo cliente mediante la función de transferencia de archivos. Establezca el valor para habilitar o bloquear la carga de archivos.

Los valores válidos son true (habilitar) y false (bloquear). El valor predeterminado es true.

Nota: Para habilitar la carga de archivos con la función de transferencia de archivos, deberá habilitar allowFileUpload en el lado cliente y también establecer la opción del GPO Configurar la transferencia de archivos para permitir la carga de archivos en el lado del agente. Consulte Funciones de escritorios remotos y GPO de Horizon.
autoForwardUSB* Activa o desactiva el redireccionamiento USB automático. El valor especifica si el redireccionamiento USB automático está activado o desactivado. La propiedad editable especifica si los usuarios pueden cambiar los ajustes de conexión automática de USB en la ventana Configuración. Los valores válidos para ambas propiedades son true y false.
display* Configura el uso de monitores locales disponibles para el cliente. Esta opción puede especificar el tamaño de la ventana del cliente. Este ajuste se activa al iniciar un escritorio remoto.
Opciones disponibles:
  • useAllMonitor: representa en todos los monitores disponibles.
  • singleMonitor: representa en un monitor usando el tamaño de ventana predeterminado.
  • singleMonitorFullscreen: representa en un monitor usando la pantalla completa.
  • singleMonitorSmallWindow: representar en un monitor con un tamaño de ventana pequeño (640x480)
  • singleMonitorLargeWindow: representa en un monitor con el tamaño de ventana grande (1680x983).
  • {width:mmm, height:nnn}: representa en un monitor usando el tamaño que usted proporcione. (mmmxnnn)

Esta opción está bloqueada si display no aparece en la lista de la propiedad editable o se establece en false. Si se establece en true en la propiedad editable, el usuario puede cambiar la opción. .

enableAdvancedTouch

Activa o desactiva la compatibilidad con los gestos táctiles avanzados, como se describe en Gestos de Panel táctil, pantalla táctil, teclado y mouse.

Los valores válidos son true (activar) y false (desactivar). El valor predeterminado es true.

enableAnonymousLogin* Configura la función Acceso sin autenticar que aparece como Iniciar sesión de forma anónima con Acceso sin autenticar en el cuadro de diálogo de configuración. La propiedad value especifica si la función está habilitada o desactivada. Los valores válidos son true y false.
enableFileAssociation

Configura el estado de activación de la función de asociación de archivos descrita en Establecer asociación de archivos. Los valores válidos son los siguientes:

  • true: la asociación de archivos está habilitada.
  • false: la asociación de archivos está desactivada. Los usuarios pueden seguir haciendo clic con el botón secundario en un archivo local y seleccionar VMware Horizon Client para Chrome, pero aparece un mensaje de advertencia en lugar de una lista de aplicaciones disponibles.

Si no se configura enableFileAssociation, la asociación de archivos estará habilitada de forma predeterminada.

enableHighResolution* Configura la función de modo de alta resolución. La propiedad value especifica si la función está activada o desactivada. La propiedad editable especifica si los usuarios pueden cambiar la opción Modo de alta resolución en Horizon Client. Los valores válidos para ambas propiedades son true y false.
enableMediaStream

Determina si los usuarios cliente pueden configurar permisos de cámara y micrófono para la función Redireccionamiento de navegador y la función Optimización de medios para Microsoft Teams para el cliente Chrome. Los valores válidos son los siguientes:

  • true: los usuarios del cliente pueden configurar los ajustes y responder a las indicaciones que permiten o deniegan el acceso de los navegadores remotos a las cámaras y los micrófonos del cliente durante el redireccionamiento del navegador.
  • false: todos los ajustes y las indicaciones relacionadas con los permisos de cámara y micrófono están ocultos para los usuarios cliente. Los usuarios no pueden configurar estos permisos. A los navegadores remotos se les deniega automáticamente el acceso a las cámaras y los micrófonos del cliente durante el redireccionamiento del navegador.

El valor predeterminado es true. Para obtener más información, consulte Configurar el redireccionamiento de navegador y la sección "Optimización de medios para Microsoft Teams" en el documento Funciones de escritorios remotos y GPO de Horizon.

enableH264 Especifica si el método de representación utiliza el modo de vídeo H.264. El cliente habilita el modo de vídeo H.264. Los valores válidos son true y false.
Nota:

Esta opción aparece solo en la ventana de configuración si el administrador no ha desactivado la función y si se utiliza una pantalla normal con una proporción superior al 100 %.

enableRTAVH264Codec

Habilita o desactiva el códec H.264 para Audio/vídeo en tiempo real. Los valores válidos son true (habilita H.264) y false (desactiva H.264).

El valor predeterminado es true.

Si desea obtener más información, consulte Utilizar la función Audio/vídeo en tiempo real para las cámaras web, los micrófonos y los altavoces.

forcePrivateMode

Habilite el modo de privacidad para Horizon Cloud on Azure next-gen. Este ajuste permite forzar la habilitación del modo de privacidad para los usuarios finales. Cuando este ajuste está habilitado, los usuarios deben autenticarse para iniciar sesión. Cuando se cierra Horizon Client o cuando se desconecta el servidor actual, se redirige al usuario a la página de cierre de sesión del navegador. Este ajuste está deshabilitado cuando no está configurado.

enableNetworkIndicator

Activa o desactiva la función de notificación de red como se describe en Detectar conexiones de red inestables. Los valores válidos son true (función activada) y false (función desactivada).

Si se establece el valor en false, se eliminará la opción Deshabilitar visualización del estado de red de la ventana Configuración.

El valor predeterminado es true.

enableLogoutTriggeredQuit Activa el cliente para que se cierre al cerrar sesión. Cuando la opción de directiva está habilitada, la opción de directiva activa el cliente para que se cierre cuando el usuario cierre sesión.

Esta opción acepta valores booleanos de tipo true o false.

enableDisconnectionTriggeredQuit Activa el cliente para que se cierre tras la desconexión de la última aplicación o escritorio activos. Cuando la opción de directiva está habilitada, la opción de directiva activa el cliente para que se cierre tras la desconexión de la última aplicación o escritorio activos.

Esta opción acepta valores booleanos de tipo true o false.

enableScreenSharing*

Permite o no permite que los usuarios compartan el contenido de su pantalla local cuando utilizan aplicaciones publicadas. Los valores válidos son true (permitir) y false (no permitir).

La propiedad editable especifica si los usuarios pueden controlar sus permisos de uso compartido de pantalla desde la ventana Configuración.

enableWebRTCRedirection*

Activa o desactiva la función de optimización de medios para aplicaciones basadas en WebRTC.

Cuando está activada, esta función optimiza las transmisiones de audio, vídeo y uso compartido de pantalla desde aplicaciones basadas en WebRTC dentro de un escritorio remoto. Esta función mejora la experiencia audio-visual general de los usuarios durante reuniones virtuales y conferencias telefónicas.

Los valores válidos son true (función activada) y false (función desactivada).

La propiedad editable especifica si los usuarios pueden controlar el estado de activación de la optimización de medios WebRTC desde la ventana Configuración.

enableWindowsKey* Activa o desactiva la tecla de Windows para escritorios remotos. El valor especifica si la función está activada o desactivada. La propiedad editable especifica si los usuarios pueden cambiar la opción Habilitar la tecla Windows para los escritorios en Horizon Client. Los valores válidos para ambas propiedades son true y false.
hardwareAccelerationOption

Configura la aceleración de hardware de la GPU del lado del cliente para Audio/vídeo en tiempo real. Si desea obtener más información, consulte Utilizar la función Audio/vídeo en tiempo real para las cámaras web, los micrófonos y los altavoces.

Los valores válidos son los siguientes:

  • no-preference permite al cliente utilizar la aceleración de hardware o la aceleración de software en función de lo que sea mejor para el sistema y la configuración. Este es el valor predeterminado.
  • prefer-hardware activa la aceleración de hardware.
  • prefer-software desactiva la aceleración de hardware y usa la aceleración de software en su lugar.
hideSecondaryServer

Configura si Horizon Client muestra un icono de servidor para los nombres de host de servidor principal y secundario, o solo para el nombre de host de servidor principal.

Los valores válidos son true (se muestra solo un icono para el nombre de host principal) y false.

  • Cuando se establece en true, Horizon Client mostrará un icono solo para el nombre de host principal.
  • Cuando se establece en false, Horizon Client mostrará un icono de servidor para los nombres de host de servidor principal y secundario. Esta opción puede hacer que se muestren dos iconos para el mismo servidor. Por ejemplo, si un equilibrador de carga funciona como host principal y Unified Access Gateway (UAG) funciona como host secundario, Horizon Client mostrará un icono para el nombre de host del equilibrador de carga y un icono duplicado para el nombre de host de UAG.

El valor predeterminado es true.

ignoreCertErrors

Configura si la función Redireccionamiento de navegador abre páginas que contienen errores de certificados de seguridad o SSL. Los valores válidos son los siguientes:

  • false: la función Redireccionamiento de navegador no abre páginas con errores de certificado o SSL. Las páginas no se redireccionan y Horizon Client muestra un mensaje sobre el error de certificado o SSL.
  • true: la función Redireccionamiento de navegador abre páginas con errores de certificado o SSL. Los errores se ignoran y las páginas se redireccionan.

El valor predeterminado es false. Si desea obtener más información, consulte Configurar el redireccionamiento de navegador.

networkStateConfig

Especifica los parámetros de umbral utilizados por Horizon Client para calcular la puntuación de calidad de la red y determinar su estabilidad. Para obtener información detallada sobre cómo utiliza Horizon Client estos parámetros, consulte Detectar conexiones de red inestables.

Este ajuste incluye las siguientes propiedades:

  • networkStateTcpRttMSLow: especifica el valor del umbral de RTT bajo usado para calcular la puntuación de calidad de la red. El valor debe ser un número entero positivo menor que el valor de networkStateTcpRttMSHigh. El valor predeterminado es 2.
  • networkStateTcpRttMSHigh: especifica el valor del umbral de RTT alto usado para calcular la puntuación de calidad de la red. El valor debe ser un número entero positivo mayor que el valor de networkStateTcpRttMSLow. El valor predeterminado es 400.
  • networkStateQualityScoreTcpThresholdGood: especifica la puntuación mínima necesaria para indicar una buena estabilidad de red. El valor debe ser un número entre 0 y 100 mayor que el valor de networkStateQualityScoreTcpThresholdPoor. El valor predeterminado es 85.
  • networkStateQualityScoreTcpThresholdPoor: especifica el límite alto del rango de puntuación que indica una estabilidad de red deficiente. El valor debe ser un número entre 0 y 100 menor que el valor de networkStateQualityScoreTcpThresholdGood. El valor predeterminado es 40.
  • networkStateRttCheckPeriodMs: especifica el intervalo de tiempo, en milisegundos, durante el que se supervisa el RTT de la red. Los valores válidos deben ser superiores a 2000. El valor predeterminado es 15000.
powerSetting Impide que el dispositivo entre en modo de suspensión en respuesta a la inactividad del usuario en una sesión remota. De forma predeterminada, el dispositivo Chrome pasa al modo de suspensión después de 10 minutos. Al configurar powerSetting, el dispositivo Chrome no entra en modo inactivo hasta que finalice la última sesión remota.

La propiedad keepAwakeLevel especifica el nivel de la política de energía. Los valores siguientes son válidos para la propiedad keepAwakeLevel:

  • system: evita que el sistema se suspenda en respuesta a la inactividad del usuario. Este valor es el predeterminado.
  • display: evita que la pantalla se apague o se atenúe, o que el sistema se suspenda en respuesta a la inactividad del usuario.
splitUSB

Especifica el comportamiento del redireccionamiento dividido para los dispositivos USB, como se describe en Dividir dispositivos USB compuestos.

Este ajuste incluye las siguientes propiedades:

  • allowList especifica los dispositivos compuestos que se pueden dividir para su redireccionamiento. Si un dispositivo no aparece en la lista, no se podrá dividir. Establezca el valor en una matriz de objetos de datos con los siguientes pares clave-valor:
    • device especifica la identidad del dispositivo compuesto. Los valores válidos usan el formato <vid>:<pid>, donde <vid> especifica el identificador de proveedor y <pid> el identificador de producto del dispositivo.
    • excludedInterface especifica las interfaces del dispositivo que no se deben redireccionar. Configure el valor como una matriz de los identificadores de interfaz excluidos.
  • blockList especifica los dispositivos compuestos que no se pueden dividir para su redireccionamiento. Configure el valor como una matriz de objetos usando el formato <vid>:<pid>, donde <vid> especifica el identificador de proveedor y <pid> el identificador de producto del dispositivo.

Cuando se utiliza esta opción, se ignora la configuración de directiva de grupo de agente equivalente (Dividir un dispositivo Vid/Pid).

urlFiltering

Configura las reglas de redireccionamiento de contenido URL para el cliente. La función Redireccionamiento de contenido URL también requiere una configuración del agente. Para obtener más información, consulte Requisitos para usar Redireccionamiento de contenido URL y "Configurar el redireccionamiento de contenido URL" en el documento Funciones de escritorios remotos y GPO de Horizon.

Nota: Deberá reiniciar Horizon Client para que se apliquen las reglas modificadas.
Nota: Las reglas de redireccionamiento de contenido URL configuradas mediante la interfaz de línea de comandos de vdmutil en una instancia de Connection Server tienen prioridad sobre el redireccionamiento de contenido URL configurado mediante la opción urlFiltering.

La opción urlFiltering incluye una propiedad, protocols, que se establece en una matriz de objetos con las siguientes propiedades:

  • brokerHostname: dirección IP o nombre de dominio completo (FQDN) del host de Connection Server que se utilizará al redireccionar las URL.
  • protocol: protocolo de URL que se redireccionará.
  • remoteItem: muestra el nombre del grupo de aplicaciones o de escritorios remotos que pueden gestionar las URL especificadas para agentRules.
  • agentRules: las URL que se redireccionan a la aplicación o al escritorio remotos especificados para remoteItem. Por ejemplo, si establece agentRules en .*mycompany.com, todas las URL que incluyan la cadena mycompany.com se redireccionarán a la aplicación o al escritorio remotos.
Nota: El rango de direcciones URL redireccionadas puede diferir en función de la sintaxis de la regla que utilice para agentRules.
  • La sintaxis de regla .*mycompany.com admite el redireccionamiento de todas las URL que contengan la cadena mycompany.com, incluida http://mycompany.com.
  • La sintaxis de regla .*.mycompany.com admite el redireccionamiento de todas las URL que contengan la cadena .mycompany.com. Sin embargo, no admite el redireccionamiento de la URL raíz. Por ejemplo, http://mycompany.com no se redireccionará.
useAssetIdReplaceMachineName

Configura cómo transferir el identificador de activo del cliente (el nombre del equipo físico) a una variable de entorno de Horizon correspondiente. Para obtener más información, consulte el artículo 92513 de la base de conocimientos de VMware.

Los valores válidos son los siguientes:

  • false: el identificador de activo se transfiere a la variable de entorno ViewClient_Asset_ID.
  • true: el identificador de activo se transfiere a la variable de entorno ViewClient_Machine_Name.

El valor predeterminado es false.

ws1WebviewMode

Configura si los usuarios pueden autenticarse en instancias de Horizon Client que se ejecutan como una aplicación administrada, como una aplicación administrada por Unified Access Gateway y Workspace ONE. Los valores válidos son los siguientes:

  • secure-webview: permite que los usuarios se autentiquen en Horizon Client como una aplicación administrada, y borra la caché y las cookies una vez completada la autenticación.
  • persistent-webview: permite que los usuarios se autentiquen en Horizon Client como una aplicación administrada, pero no borra la caché ni las cookies una vez completada la autenticación. Este valor permite el almacenamiento de información de autenticación.
  • browser: requiere la apertura de una ventana del navegador para la autenticación del usuario. Este valor impide que Horizon Client se ejecute como una aplicación administrada.

El valor predeterminado es secure-webview.

El siguiente ejemplo de un archivo de configuración JSON muestra la configuración común y el uso de la propiedad editable. En este ejemplo se muestran los ajustes recomendados que maximizan el rendimiento y la eficiencia para obtener una experiencia de usuario óptima.

{
  "broker_list": {
    "Value": {
      "settings": {
        "server-list": [
          {
            "server": "viewserver0.mydomain.com",
            "default": true,
            "description": "View Server 0",
            "username": "User0",
            "domain": "TestDomain0"
          }
        ],
        "common-setting": {
          "allowDataSharing": true,
          "enableAdvancedTouch": true,
          "enableAnonymousLogin": false,
          "allowFileDownload": true,
          "allowFileUpload": true,
          "enableWindowsKey": true,
          "enableFileAssociation": false,
          "enableH264": true,
          "enableRTAVH264Codec": true,
          "forcePrivateMode": true,
          "hardwareAccelerationOption": "no-preference",
          "ignoreCertErrors": false,
          "ws1WebviewMode": "secure-webview",
          "autoForwardUSB": true,
          "display": "useAllMonitor",
          "enableHighResolution": false,
          "useAssetIdReplaceMachineName": false,
          "splitUSB": {
            "allowList": [
              {
                "device": "0554:1001",
                "excludedInterface": [
                  "00",
                  "01",
                  "02"
                ]
              }
            ]
          },
          "hideSecondaryServer": true,
          "enableAdvancedTouch": false,
          "enableMediaStream": false,
          "enableScreenSharing": true,
          "enableNetworkIndicator": true,
          "enableLogoutTriggeredQuit": true,
          "enableDisconnectionTriggeredQuit": true,
           }
          "networkStateConfig": {
            "networkStateTcpRttMSLow": 2,
            "networkStateTcpRttMSHigh": 400,
            "networkStateQualityScoreTcpThresholdGood": 85,
            "networkStateQualityScoreTcpThresholdPoor": 40,
            "networkStateRttCheckPeriodMs": 15000
          },
          "urlFiltering": {
            "protocols": [
              {
                "brokerHostname": "10.117.24.28",
                "protocol": "http",
                "remoteItem": "win2022_RDSH",
                "agentRules": ".*example1.com"
              },
              {
                "brokerHostname": "10.117.161.109",
                "protocol": "https",
                "remoteItem": "win10_VDI",
                "agentRules": ".*example2.com"
              }
            ]
          },
          "editable": {
            "allowDataSharing": true,
            "enableAnonymousLogin": true,
            "enableHighResolution": true,
            "autoForwardUSB": true,
            "enableH264": true,
            "enableWebRTCRedirection": true,
            "display": true,
            "enableScreenSharing": true
          }
        }
      }
    }
  }
}