Pour configurer certaines fonctionnalités d'Horizon Client, vous pouvez utiliser les paramètres de la section common-setting. La propriété editable indique la disponibilité des paramètres que l'utilisateur doit modifier. Un astérisque dans le tableau suivant indique les paramètres que vous pouvez configurer dans la liste modifiable.

Note : Pour s'assurer que les paramètres modifiés s'appliquent, les utilisateurs doivent redémarrer Horizon Client.
Paramètre Description
editable Configure une liste de paramètres d'Horizon Client et spécifie si un utilisateur peut modifier certaines valeurs common settings. En général, la stratégie de chaque serveur détermine la valeur des paramètres. Vous pouvez ajouter n'importe quelle fonctionnalité client dans ce tableau marqué d'un astérisque (*).

Si la valeur d'un paramètre répertorié dans la propriété editable est false, ce paramètre n'est pas disponible. L'utilisateur ne peut pas modifier ce paramètre. L'interface utilisateur s'affiche en gris. Pour apporter des modifications, l'administrateur système peut mettre à jour la stratégie définie par le serveur.

Si un paramètre se trouve dans la liste de propriétés editable et qu'il est défini sur true, il est disponible dans l'interface utilisateur. L'utilisateur peut apporter une modification.

Note : Lors de la première utilisation, le client applique tous les paramètres de la stratégie pour le serveur. Après cela, si le paramètre est modifiable et a été modifié par l'utilisateur, le client utilise ce paramètre.
allowDataSharing* Configure la fonctionnalité de partage de données. Définissez cette valeur pour activer ou désactiver le partage. Les valeurs valides sont true (activer) et false (désactiver).
allowFileDownload

Indique si les utilisateurs peuvent télécharger des fichiers depuis un poste de travail distant vers le périphérique client à l'aide de la fonctionnalité de transfert de fichiers. Définissez cette valeur pour activer ou bloquer le téléchargement de fichiers.

Les valeurs valides sont true (activer) et false (bloquer). La valeur par défaut est true.

Note : Pour activer le téléchargement de fichiers avec la fonctionnalité de transfert de fichiers, vous devez activer allowFileDownload côté client et également définir le paramètre de GPO Configurer le transfert de fichiers pour autoriser le téléchargement de fichiers côté agent. Reportez-vous à la section Fonctionnalités et GPO des postes de travail distants Horizon.
allowFileUpload

Indique si les utilisateurs peuvent charger des fichiers sur un poste de travail distant depuis le périphérique client à l'aide de la fonctionnalité de transfert de fichiers. Définissez cette valeur pour activer ou bloquer le chargement de fichiers.

Les valeurs valides sont true (activer) et false (bloquer). La valeur par défaut est true.

Note : Pour activer le chargement de fichiers avec la fonctionnalité de transfert de fichiers, vous devez activer allowFileUpload côté client et également définir le paramètre de GPO Configurer le transfert de fichiers pour autoriser le chargement de fichiers côté agent. Reportez-vous à la section Fonctionnalités et GPO des postes de travail distants Horizon.
autoForwardUSB* Active ou désactive la redirection USB automatique. La valeur spécifie si la redirection USB automatique est activée ou désactivée. La propriété editable indique si les utilisateurs peuvent modifier les paramètres de connexion automatique USB dans la fenêtre Paramètres. Les valeurs valides pour les deux propriétés sont true et false.
display* Configure l'utilisation des moniteurs locaux disponibles pour le client. Ce paramètre peut spécifier la taille de la fenêtre du client. Ce paramètre s'active au lancement d'un poste de travail distant.
Options disponibles :
  • useAllMonitor : rendu dans tous les moniteurs disponibles.
  • singleMonitor : rendu sur un moniteur en utilisant la taille de fenêtre par défaut.
  • singleMonitorFullscreen : rendu sur un seul moniteur à l'aide du mode plein écran.
  • singleMonitorSmallWindow : rendu sur un moniteur à l'aide d'une petite taille de fenêtre (640 x 480)
  • singleMonitorLargeWindow : rendu sur un moniteur à l'aide de la grande taille de fenêtre (1 680 x 983).
  • {width:mmm, height:nnn} : rendu sur un moniteur en utilisant la taille que vous fournissez. (mmm x nnn)

Ce paramètre est verrouillé si display est manquant dans la liste de la propriété editable ou défini sur false. Si le paramètre est défini sur true dans la propriété editable, l'utilisateur peut modifier le premier. .

enableAdvancedTouch

Active ou désactive la prise en charge des gestes tactiles avancés, comme décrit dans la section Mouvements du pavé tactile, de l'écran tactile, du pavé numérique et de la souris.

Les valeurs valides sont true (activer) et false (désactiver). La valeur par défaut est true.

enableAnonymousLogin* Configure la fonctionnalité Accès non authentifié qui s'affiche sous la forme Se connecter de manière anonyme à l'aide de l'accès non authentifié dans la boîte de dialogue des paramètres. La propriété value spécifie si la fonctionnalité est activée ou désactivée. Les valeurs valides sont true et false.
enableFileAssociation

Configure l'état d'activation de la fonctionnalité d'association de fichiers décrite dans Définir l'association de fichiers. Les valeurs valides sont les suivantes :

  • true : l'association de fichiers est activée.
  • false : l'association de fichiers est désactivée. Les utilisateurs peuvent toujours cliquer avec le bouton droit sur un fichier local et sélectionner VMware Horizon Client pour Chrome. Toutefois, un message d'avertissement s'affiche à la place d'une liste d'applications disponibles.

Si l'option enableFileAssociation n'est pas configurée, l'association de fichiers est activée par défaut.

enableHighResolution* Configure la fonctionnalité Mode haute résolution. La propriété value spécifie si la fonctionnalité est activée ou désactivée. La propriété editable spécifie si les utilisateurs peuvent modifier le paramètre Mode haute résolution dans Horizon Client. Les valeurs valides pour les deux propriétés sont true et false.
enableMediaStream

Détermine si les utilisateurs du client peuvent configurer des autorisations d'accès à la caméra et au microphone pour la fonctionnalité de redirection de navigateur et la fonctionnalité d'optimisation des supports pour Microsoft Teams pour le client Chrome. Les valeurs valides sont les suivantes :

  • true : les utilisateurs du client peuvent configurer les paramètres et répondre aux invites qui autorisent ou refusent l'accès des navigateurs distants aux caméras et aux microphones du client lors de la redirection de navigateur.
  • false : l'ensemble des paramètres et invites liés aux autorisations d'accès à la caméra et au microphone sont masqués pour les utilisateurs du client. Les utilisateurs ne peuvent pas configurer ces autorisations. Les navigateurs distants se voient automatiquement refuser l'accès aux caméras et aux microphones des clients lors de la redirection de navigateur.

La valeur par défaut est true. Pour plus d'informations, reportez-vous à Configurer la redirection de navigateur et à la section « Optimisation des supports pour Microsoft Teams » du document Fonctionnalités et GPO des postes de travail distants Horizon.

enableH264 Spécifie si la méthode de rendu utilise le mode vidéo H.264. Le client active le mode vidéo H.264. Les valeurs valides sont true et false.
Note :

Cette option s'affiche dans la fenêtre des paramètres uniquement si vous utilisez un affichage normal avec un taux supérieur à 100 % et si l'administrateur n'a pas désactivé la fonctionnalité.

enableRTAVH264Codec

Active ou désactive le codec H.264 pour l'Audio/Vidéo en temps réel. Les valeurs valides sont true (activer H.264) et false (désactiver H.264).

La valeur par défaut est true.

Pour plus d'informations, reportez-vous à la section Utilisation de la fonctionnalité Audio/Vidéo en temps réel pour les webcams, les microphones et les haut-parleurs.

forcePrivateMode

Activez le mode de confidentialité pour Horizon Cloud on Azure next-gen. Ce paramètre permet de forcer l'activation du mode de confidentialité pour les utilisateurs finaux. Lorsque ce paramètre est activé, les utilisateurs doivent s'authentifier pour se connecter. L'utilisateur est ensuite dirigé vers la page de déconnexion du navigateur lors de la fermeture d'Horizon Client ou de la déconnexion du serveur actuel. Ce paramètre est désactivé lorsqu'il n'est pas configuré

enableNetworkIndicator

Active ou désactive la fonctionnalité de notification réseau, comme décrit dans la section Détecter les connexions réseau instables. Les valeurs valides sont true (fonctionnalité activée) et false (fonctionnalité désactivée).

Si vous définissez la valeur sur false, l'option Désactiver l'affichage de l'état du réseau est supprimée de la fenêtre Paramètres.

La valeur par défaut est true.

enableLogoutTriggeredQuit Déclenche la fermeture du client lors de la déconnexion. Lorsque l'option de stratégie est activée, elle déclenche la fermeture du client lorsque l'utilisateur se déconnecte.

Cette option accepte les valeurs booléennes de type true ou false.

enableDisconnectionTriggeredQuit Déclenche la fermeture du client lors de la déconnexion du dernier poste de travail actif ou de la dernière application active. Lorsque l'option de stratégie est activée, elle déclenche la fermeture du client lors de la déconnexion du dernier poste de travail actif ou de la dernière application active.

Cette option accepte les valeurs booléennes de type true ou false.

enableScreenSharing*

Autorise ou non les utilisateurs à partager le contenu de leur écran local lors de l'utilisation d'applications publiées. Les valeurs valides sont true (autoriser) et false (interdire).

La propriété editable spécifie si les utilisateurs peuvent contrôler leurs autorisations de partage d'écran dans la fenêtre Paramètres.

enableWebRTCRedirection*

Active ou désactive la fonctionnalité d'optimisation des supports pour les applications basées sur WebRTC.

Lorsqu'elle est activée, cette fonctionnalité optimise les flux audio, vidéo et de partage d'écran à partir d'applications basées sur WebRTC d'un poste de travail distant. Cette fonctionnalité améliore l'expérience audiovisuelle globale des utilisateurs lors de réunions virtuelles et de conférences téléphoniques.

Les valeurs valides sont true (fonctionnalité activée) et false (fonctionnalité désactivée).

La propriété editable spécifie si les utilisateurs peuvent contrôler l'état d'activation de l'optimisation des supports WebRTC dans la fenêtre Paramètres.

enableWindowsKey* Active ou désactive la touche Windows pour les postes de travail distants. La valeur spécifie si la fonctionnalité est activée ou désactivée. La propriété editable spécifie si les utilisateurs peuvent modifier le paramètre Activer la touche Windows pour les postes de travail dans Horizon Client. Les valeurs valides pour les deux propriétés sont true et false.
hardwareAccelerationOption

Configure l'accélération matérielle du GPU côté client pour l'Audio/Vidéo en temps réel. Pour plus d'informations, reportez-vous à la section Utilisation de la fonctionnalité Audio/Vidéo en temps réel pour les webcams, les microphones et les haut-parleurs.

Les valeurs valides sont les suivantes :

  • no-preference permet au client de choisir entre l'accélération matérielle et l'accélération logicielle en fonction de ce qui convient le mieux pour le système et la configuration. Il s'agit de la valeur par défaut.
  • prefer-hardware active l'accélération matérielle.
  • prefer-software désactive l'accélération matérielle et utilise l'accélération logicielle à la place.
hideSecondaryServer

Indique si Horizon Client affiche une icône de serveur pour les noms d'hôtes des serveurs principal et secondaire, ou pour le nom d'hôte du serveur principal uniquement.

Les valeurs valides sont true (afficher une icône unique pour le nom d'hôte principal uniquement) et false.

  • Lorsque cette option est définie sur true, Horizon Client affiche une icône pour le nom d'hôte principal uniquement.
  • Lorsque cette option est définie sur false, Horizon Client affiche une icône de serveur pour les noms d'hôtes des serveurs principal et secondaire. Ce paramètre peut entraîner l'affichage de deux icônes pour le même serveur. Par exemple, dans le cas où un équilibrage de charge fonctionne comme hôte principal et Unified Access Gateway (UAG) fonctionne comme hôte secondaire, Horizon Client affiche une icône pour le nom d'hôte de l'équilibrage de charge et une icône en double pour le nom d'hôte UAG.

La valeur par défaut est true.

ignoreCertErrors

Indique si la fonctionnalité de redirection de navigateur ouvre ou non des pages contenant des erreurs de certificat de sécurité ou SSL. Les valeurs valides sont les suivantes :

  • false : la fonctionnalité de redirection de navigateur n'ouvre pas les pages contenant des erreurs de certificat ou SSL. Les pages ne sont pas redirigées, et Horizon Client affiche un message sur l'erreur de certificat ou SSL.
  • true : la fonctionnalité de redirection de navigateur procède à l'ouverture des pages avec des erreurs de certificat ou SSL. Les erreurs sont ignorées et les pages sont redirigées.

La valeur par défaut est false. Pour plus d'informations, reportez-vous à la section Configurer la redirection de navigateur.

networkStateConfig

Spécifie les paramètres de seuil utilisés par Horizon Client pour calculer le score de qualité du réseau et déterminer la stabilité du réseau. Pour obtenir des informations détaillées sur la façon dont Horizon Client utilise ces paramètres, reportez-vous à la section Détecter les connexions réseau instables.

Ce paramètre inclut les propriétés suivantes :

  • networkStateTcpRttMSLow : spécifie la valeur de seuil RTT faible utilisée pour calculer le score de qualité du réseau. La valeur doit être un entier positif inférieur à la valeur networkStateTcpRttMSHigh. La valeur par défaut est 2.
  • networkStateTcpRttMSHigh : spécifie la valeur de seuil RTT élevée utilisée pour calculer le score de qualité du réseau. La valeur doit être un entier positif supérieur à la valeur networkStateTcpRttMSLow. La valeur par défaut est 400.
  • networkStateQualityScoreTcpThresholdGood : spécifie le score minimal requis pour indiquer une bonne stabilité du réseau. Les valeurs valides doivent être comprises entre 0 et 100 et être supérieures à la valeur networkStateQualityScoreTcpThresholdPoor. La valeur par défaut est 85.
  • networkStateQualityScoreTcpThresholdPoor : spécifie la limite élevée de la plage de scores indiquant une mauvaise stabilité du réseau. Les valeurs valides doivent être comprises entre 0 et 100 et inférieures à la valeur networkStateQualityScoreTcpThresholdGood. La valeur par défaut est 40.
  • networkStateRttCheckPeriodMs : spécifie l'intervalle de temps, en millisecondes, pendant lequel la valeur RTT du réseau est surveillée. Les valeurs valides doivent être supérieures à 2 000. La valeur par défaut est 15 000.
powerSetting Empêche le périphérique de passer en mode veille en réponse à l'inactivité de l'utilisateur dans une session distante. Par défaut, le périphérique Chrome passe en mode veille au bout de 10 minutes. Lorsque vous configurez la propriété powerSetting, le périphérique ne passe pas en mode veille jusqu'à la fin de la dernière session distante.

La propriété keepAwakeLevel spécifie le niveau de la stratégie d'alimentation. Les valeurs suivantes sont valides pour la propriété keepAwakeLevel :

  • System : empêche le système de passer en veiller en réponse à l'inactivité de l'utilisateur. Il s'agit de la valeur par défaut.
  • Display : empêche l'affichage de se désactiver ou de s'estomper, ou le système de passer en veille, en réponse à l'inactivité de l'utilisateur.
splitUSB

Spécifie le comportement de redirection de fractionnement pour les périphériques USB, comme décrit dans la section Périphériques USB composites fractionnés.

Ce paramètre inclut les propriétés suivantes :

  • allowList spécifie les périphériques composites dont le fractionnement est autorisé pour la redirection. Si un périphérique n'est pas répertorié, il n'est pas fractionné. Définissez la valeur sur un tableau d'objets de données avec les paires clé-valeur suivantes :
    • device spécifie l'identité du périphérique composite. Les valeurs valides sont au format <vid>:<pid>, où <vid> indique l'ID de fournisseur et <pid> indique l'ID de produit du périphérique.
    • excludedInterface spécifie les interfaces du périphérique qui ne doivent pas être redirigées. Configurez la valeur en tant que tableau des ID d'interface exclus.
  • blockList spécifie les périphériques composites dont le fractionnement n'est pas autorisé pour la redirection. Configurez la valeur en tant que tableau d'objets au format <vid>:<pid>, où <vid> indique l'ID de fournisseur et <pid> indique l'ID de produit du périphérique.

Lorsque ce paramètre est utilisé, le paramètre de stratégie de groupe d'agent équivalent (Fractionner un périphérique Vid/Pid) est ignoré.

urlFiltering

Configure les règles de redirection de contenu URL pour le client. La fonctionnalité de redirection de contenu URL nécessite également une configuration côté agent. Pour plus d'informations, reportez-vous aux sections Configuration requise pour l'utilisation de la redirection de contenu URL et « Configuration de la redirection de contenu URL » du document Fonctionnalités et GPO des postes de travail distants Horizon.

Note : Vous devez redémarrer Horizon Client pour appliquer toutes les règles modifiées.
Note : Les règles de redirection de contenu URL configurées à l'aide de l'interface de ligne de commande vdmutil sur une instance du Serveur de connexion sont prioritaires sur celles de redirection de contenu URL configurées à l'aide du paramètre urlFiltering.

Le paramètre urlFiltering dispose de la propriété protocols, qui est définie sur un tableau d'objets avec les propriétés suivantes :

  • brokerHostname : adresse IP ou nom de domaine complet (FQDN) de l'hôte du Serveur de connexion à utiliser lors de la redirection d'URL.
  • Protocol : protocole d'URL à rediriger.
  • remoteItem : nom complet du pool d'applications ou de postes de travail distants qui peut traiter les URL spécifiées pour agentRules.
  • agentRules : URL redirigées vers l'application ou le poste de travail distant indiqué pour remoteItem. Par exemple, si vous définissez agentRules sur .*mycompany.com, toutes les URL qui incluent la chaîne mycompany.com sont redirigées vers l'application ou le poste de travail distant.
Note : La plage d'URL redirigées peut varier en fonction de la syntaxe de règle que vous utilisez pour agentRules.
  • La syntaxe de règle .*mycompany.com prend en charge la redirection de toutes les URL qui contiennent la chaîne mycompany.com, y compris http://mycompany.com.
  • La syntaxe de règle .*.mycompany.com prend en charge la redirection de toutes les URL qui contiennent la chaîne .mycompany.com. Il ne prend pas en charge la redirection de l'URL racine. Par exemple, http://mycompany.com n'est pas redirigé.
useAssetIdReplaceMachineName

Configure le mode de transmission de l'ID de ressource client (nom de l'ordinateur physique) à une variable d'environnement Horizon correspondante. Pour plus d'informations, reportez-vous à l'article 92513 de la base de connaissances VMware.

Les valeurs valides sont les suivantes :

  • false : l'ID de ressource est transmis à la variable d'environnement ViewClient_Asset_ID.
  • true : l'ID de ressource est transmis à la variable d'environnement ViewClient_Machine_Name.

La valeur par défaut est false.

ws1WebviewMode

Indique si les utilisateurs peuvent s'authentifier dans Horizon Client s'exécutant comme application gérée par Unified Access Gateway et Workspace ONE. Les valeurs valides sont les suivantes :

  • Secure-webview : permet aux utilisateurs de s'authentifier dans Horizon Client comme application gérée, et efface le cache et les cookies à la fin de l'authentification.
  • persistent-webview : permet aux utilisateurs de s'authentifier dans Horizon Client comme application gérée, mais n'efface pas le cache et les cookies à la fin de l'authentification. Cette valeur permet le stockage des informations d'authentification.
  • browser : nécessite l'ouverture d'une fenêtre du navigateur pour l'authentification utilisateur. Cette valeur empêche l'exécution d'Horizon Client comme application gérée.

La valeur par défaut est secure-webview.

L'exemple suivant d'un fichier de configuration JSON indique les paramètres communs et l'utilisation de la propriété modifiable. Cet exemple montre les paramètres recommandés qui optimisent les performances et l'efficacité pour une expérience utilisateur optimale.

{
  "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
          }
        }
      }
    }
  }
}