Vous pouvez inclure des propriétés spécifiques lorsque vous installez silencieusement Horizon Agent pour Windows à partir de la ligne de commande. Vous devez utiliser un format PROPERTY=value de manière que Microsoft Windows Installer (MSI) puisse interpréter les propriétés et les valeurs. Une mise à niveau silencieuse utilise les mêmes commandes d'installation. Vous pouvez également modifier les composants d'Horizon Agent installés en silence.
Le tableau suivant montre les propriétés de l'installation silencieuse d'Horizon Agent que vous pouvez utiliser sur la ligne de commande.
Remarque : les étapes ci-dessous utilisent le nom agent-installer.exe pour faire référence au fichier du programme d'installation.
Propriétés MSI de l'installation silencieuse d'Horizon Agent
| Propriété MSI | Description | Valeur par défaut |
|---|---|---|
| ENABLE_UNC_REDIRECTION | Indique si la fonctionnalité de redirection de chemin UNC est installée. La fonctionnalité sera installée si la valeur est égale à 1. Vous devez utiliser les paramètres de stratégie de groupe pour configurer les chemins UNC à rediriger. Reportez-vous à la section « Configuration de la redirection de chemin UNC » du document Fonctionnalités et GPO des postes de travail distants Horizon. Cette propriété MSI est facultative. | 0 |
| HORIZON_MONITOR_ENABLED | Indique si le mode de surveillance d'Horizon doit être activé ou désactivé. Cet indicateur fonctionne uniquement si Horizon Cloud Service - next-gen est installé dans votre environnement. Une valeur de 1 active le mode de surveillance d'Horizon. Une valeur de 0 désactive la surveillance d'Horizon. | 0 |
| IGNORE_DOTNET_CHECK | Détermine si le programme d'installation recherche une version .NET minimale. Par défaut, lorsqu'Horizon Performance Tracker est sélectionné, le programme d'installation effectue une vérification préalable pour confirmer que .NET 4.6.2 ou une version ultérieure est installé et arrête le processus d'installation s'il ne l'est pas. La valeur 1 annule cette vérification préalable. Une valeur de 0 permet à la vérification préalable de continuer. | 0 |
| INSTALLDIR | Chemin d'accès et dossier dans lequel le logiciel Horizon Agent est installé. Par exemple :
INSTALLDIR=""D:\abc\my folder""
Les jeux de deux guillemets doubles entourant le chemin autorisent le programme d'installation MSI à ignorer l'espace dans le chemin.
Cette propriété MSI est facultative. | %ProgramFiles%\Omnissa\Horizon\Agent |
| RDP_CHOICE | Détermine l'activation du protocole RDP (Remote Desktop Protocol) sur le poste de travail. Une valeur de 1 active RDP. Une valeur de 0 laisse le paramètre RDP désactivé. Cette propriété MSI est facultative. | 1 |
| SUPPRESS_RUNONCE_CHECK | Ignore les tâches de Windows Update en attente planifiées au prochain redémarrage du système d'exploitation dans les clés HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\RunOnce et RunOnceEx. L'utilisation de cet indicateur permet l'installation simultanée, mais ne garantit pas le résultat de l'installation lorsque les mises à jour système affectent les dépendances d'exécution d'Horizon Agent.
Cette propriété MSI est facultative.La valeur 1 ignore la vérification des clés de registre RunOnce. La valeur par défaut est 0, si elle n'est pas définie sur la ligne de commande. | 0 (si elle n'est pas définie sur la ligne de commande) |
| URL_FILTERING_ENABLED | Indique si la fonctionnalité de redirection de contenu URL est installée. La fonctionnalité sera installée si la valeur est égale à 1. Vous devez utiliser les paramètres de stratégie de groupe pour configurer quelles URL doivent être redirigées. Reportez-vous à la section « Configuration de la redirection de contenu URL » du document Fonctionnalités et GPO des postes de travail distants Horizon. Cette propriété MSI est facultative. | 0 |
| VDM_SKIP_BROKER_REGISTRATION | La valeur 1 ignore les postes de travail non gérés. | Aucun |
| VDM_VC_MANAGED_AGENT | Détermine si vCenter Server gère la machine virtuelle sur laquelle Horizon Agent est installé.
Une valeur de 1 configure le poste de travail en tant que machine virtuelle gérée par vCenter Server.
Une valeur de 0 configure le poste de travail en tant que machines physiques et machines non gérées par vSphere.
Cette propriété MSI est requise.
Remarque : l'option de réparation du programme d'installation n'est pas prise en charge pour une installation non gérée. La réparation d'une telle installation entraîne l'installation d'une instance gérée d'Horizon Agent. | Aucun |
| VDM_REINSTALL | Spécifie une liste des fonctionnalités déjà installées, délimitées par des virgules, qui doivent être réinstallées, applicables uniquement en mode silencieux. | Aucun |
| VDM_REINSTALLMODE | Chaîne contenant des lettres spécifiant le type de réinstallation à effectuer, applicable uniquement en mode silencieux. Pour plus de détails sur les options à utiliser, reportez-vous à la page https://learn.microsoft.com/fr-fr/windows/win32/msi/reinstallmode. | Aucun |
| VDM_SERVER_NAME | Nom d'hôte ou adresse IP de l'instance du Serveur de connexion sur laquelle le programme d'installation d'Horizon Agent inscrit un poste de travail non géré. Cette propriété MSI s'applique uniquement aux postes de travail non gérés.
Par exemple : VDM_SERVER_NAME=10.123.01.01
N'utilisez pas cette propriété MSI pour les postes de travail virtuels gérés par vCenter Server. Rappel : cette page décrit les paramètres d'installation d'Horizon Agent sur une machine Windows et VDM_SERVER_NAME est le nom de paramètre correct pour ce cas d'utilisation d'installation d'Horizon Agent et de spécification de l'instance du Serveur de connexion. Cela est différent du cas d'utilisation dans lequel vous essayez d'installer Horizon Client sur une machine Windows. Ce cas d'utilisation lié au client a un nom de paramètre similaire, mais différent, pour spécifier le Serveur de connexion pour l'installation d'Horizon Client. Si vous étudiez le cas d'utilisation d'installation d'Horizon Client pour Windows, reportez-vous plutôt au Guide d'Omnissa Horizon Client pour Windows et à sa page sur l'installation d'Horizon Client pour Windows à l'aide de la ligne de commande. | Aucun |
| VDM_SERVER_USERNAME | Nom d'utilisateur de l'administrateur sur l'instance du Serveur de connexion. Cette propriété MSI s'applique uniquement aux postes de travail non gérés.
Par exemple : VDM_SERVER_USERNAME=domain\username
N'utilisez pas cette propriété MSI pour les postes de travail virtuels gérés par vCenter Server. | Aucun |
| VDM_SERVER_PASSWORD | Mot de passe de l'utilisateur administrateur du Serveur de connexion. Cette propriété MSI s'applique uniquement aux postes de travail non gérés.
Par exemple : VDM_SERVER_PASSWORD=secret
N'utilisez pas cette propriété MSI pour les postes de travail virtuels gérés par vCenter Server. | Aucun |
| VDM_IP_PROTOCOL_USAGE | Spécifie la version IP qu'Horizon Agent utilise. Les valeurs valides sont IPv4 et IPv6. | IPv4 |
| VDM_FIPS_ENABLED | Indique si le mode FIPS doit être activé ou désactivé. Une valeur de 1 active le mode FIPS. Une valeur de 0 désactive le mode FIPS. Si cette propriété est définie sur 1 et que Windows n'est pas en mode FIPS, le programme d'installation s'arrête. | 0 |
| VDM_FORCE_DESKTOP_AGENT | Si vous installez Horizon Agent sur une machine Windows Server et que vous la configurez comme poste de travail Horizon mono-utilisateur plutôt que comme hôte RDS, définissez la valeur sur 1. Cette condition s'applique aux machines gérées par vCenter Server, ainsi qu'aux machines non gérées. Pour les invités Windows non-serveur qui hébergent des sessions d'application hôtes, définissez la valeur sur 0. Cette propriété MSI est facultative. | 0 |
| VDM_PAIRING_MECHANISM | Spécifie la méthode de couplage. Les valeurs suivantes sont autorisées :
1 = Spécifier le nom d'hôte du Serveur de connexion (par défaut). Nécessite VDM_SERVER_NAME, VDM_SERVER_USERNAME et VDM_SERVER_PASSWORD. 2 = Détecter automatiquement le Serveur de connexion. Aucune information d'identification n'est nécessaire. 3 = Spécifier le nom de l'espace. Nécessite VDM_POD_NAME. Aucune information d'identification n'est nécessaire. Remarque : pour utiliser les valeurs 2 et 3, la machine doit être enregistrée dans Horizon Console avant l'installation de l'agent. | 1 |
| VDM_POD_NAME | Spécifie le nom de l'espace. Par exemple : VDM_POD_NAME=HorizonPodName requis lorsque VDM_PAIRING_MECHANISM=3. | Aucun |
Dans une commande d'installation silencieuse, vous pouvez utiliser la propriété ADDLOCAL pour spécifier des options à configurer par le programme d'installation d'Horizon Agent.
Le tableau suivant montre les options d'Horizon Agent que vous pouvez entrer sur la ligne de commande. Ces options ont des options de configuration correspondantes que vous pouvez décocher ou cocher pendant une installation interactive.
Lorsque vous n'utilisez pas la propriété ADDLOCAL sur la ligne de commande, Horizon Agent installe toutes les options installées par défaut lors d'une installation interactive, si elles sont prises en charge sur le système d'exploitation invité. Lorsque vous utilisez ADDLOCAL=ALL, Horizon Agent installe toutes les options suivantes, à la fois celles activées par défaut et celles désactivées par défaut, si elles sont prises en charge sur le système d'exploitation invité.
Pour plus d'informations, reportez-vous à l'entrée de tableau ADDLOCAL dans Options de la ligne de commande Microsoft Windows Installer.
Si vous utilisez ADDLOCAL pour spécifier des fonctionnalités de manière individuelle (vous ne spécifiez pas ADDLOCAL=ALL), vous devez alors spécifier Core.
Vous pouvez modifier les fonctionnalités en utilisant les propriétés MSI ADDLOCAL et REMOVE. Utilisez la commande PowerShell suivante pour interroger le registre des composants installés sur le système sur lequel Horizon Agent est installé pour la ligne de commande de base ModifyPath :
Get-ItemProperty HKLM:\Software\Microsoft\Windows\CurrentVersion\Uninstall\* |
Select-Object DisplayName, ModifyPath | Where-Object {$_.DisplayName -like '*Horizon Agent*'} | Format-Table –AutoSize
Sortie :
DisplayName ModifyPath
Omnissa Horizon Agent MsiExec.exe /I{A17DD662-DFB3-4997-9C0F-4E687A300111}
Remarque : dans les exemples suivants, le nom agent-installer correspond au nom du fichier du programme d'installation d'Horizon Agent pour Windows. Remplacez-le par le nom réel du fichier.
L'exemple suivant modifie et supprime le composant USB d'une installation existante : agent-installer.exe /s /v"/qn REMOVE=USB"
L'exemple suivant modifie l'installation de l'agent en remplaçant Horizon Performance Tracker par Horizon Help Desk Tool : agent-installer.exe /s /v"/qn ADDLOCAL=HelpDesk REMOVE=PerfTracker”
L'exemple suivant modifie l'installation de l'agent en ajoutant le port série et la redirection de scanner : agent-installer.exe /s /v"/qn ADDLOCAL=SerialPortRedirection,ScannerRedirection”
Options d'installation silencieuse d'Horizon Agent et options d'installation personnalisée interactive
| Option d'installation silencieuse | Option de l'installation personnalisée dans une installation interactive | Installée par défaut de façon interactive ou lorsque l'élément ADDLOCAL n'est pas utilisé |
|---|---|---|
| Core | Fonctions principales d'Horizon Agent. Si vous spécifiez ADDLOCAL=ALL, les fonctionnalités Core sont installées. | Oui |
| USB | Redirection USB | Non |
| NGVC | Instant Clone Agent | Non |
| RTAV | Audio/Vidéo en temps réel | Oui |
| ClientDriveRedirection | Redirection du lecteur client | Oui |
| SerialPortRedirection | Redirection de port série | Non |
| ScannerRedirection | Redirection de scanner | Non |
| GEOREDIR | Redirection de géolocalisation | Non |
| Déconseillé : V4V | L'option V4V est déconseillée à partir d'Horizon 8 version 2412 et n'est plus incluse dans le programme d'installation. | Non |
| SmartCard | Carte à puce Cette fonctionnalité n'est pas installée par défaut dans une installation interactive. | Non |
| HznVaudio | Audio (pilote audio virtuel) | Oui |
| HznVidd, HznVidd2 | Pilote d'affichage indirect | Oui
Il s'agit de composants masqués, non facultatifs, qui sont toujours installés.
Remarque : HznVidd est installé et marqué comme local dans le registre uniquement si :
|
| TSMMR | Redirection multimédia Windows Media (MMR) | Oui |
| RDP | Active RDP dans le registre si vous utilisez la propriété RDP_CHOICE=1 sur la ligne de commande ou si vous sélectionnez RDP comme protocole d'affichage par défaut lorsque vous créez ou modifiez un pool de postes de travail. Cette fonctionnalité est masquée lors des installations interactives. | Oui |
| RDSH3D | Rendu 3D sur des hôtes RDS | Non |
| BlastUDP | Prise en charge du transport UDP pour Blast | Oui |
| SdoSensor | Redirection du capteur d'orientation de périphérique simple | Non |
| PerfTracker | Horizon Performance Tracker | Non |
| Support technique | Horizon Help Desk Tool | Oui |
| PrintRedir | Integrated Printing | Oui |
| PSG | Cette fonctionnalité définit une entrée de registre qui indique au Serveur de connexion View si Horizon Agent utilise IPv4 ou IPv6. | Oui |
| StorageDriveRedir | Redirection de lecteur de stockage | Non |
Cette page vous a-t-elle été utile ?