Vous pouvez inclure des propriétés spécifiques lorsque vous installez silencieusement Horizon Agent for Windows à partir de la ligne de commande. Vous devez utiliser le 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 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.
| 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 VMware 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. |
%ProgramFiles%\VMware\VMware View\Agent |
| INSTALLDIR | Chemin d'accès et dossier où 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. |
|
| 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. |
Aucun |
| URL_FILTERING_ENABLED | Spécifie 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 comme étant non géré par vCenter Server. Cette propriété MSI est requise.
Note : 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é s'applique uniquement à des postes de travail non gérés. Par exemple : VDM_SERVER_NAME=10.123.01.01 Cette propriété MSI est requise pour les postes de travail non gérés. N'utilisez pas cette propriété MSI pour les postes de travail virtuels gérés par vCenter Server. |
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=domaine\nomutilisateur Cette propriété MSI est requise pour les postes de travail non gérés. 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. Par exemple : VDM_SERVER_PASSWORD=secret Cette propriété MSI est requise pour les postes de travail non gérés. 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 | Indiquez 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 |
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 répertorie les options 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.
Get-ItemProperty HKLM:\Software\Microsoft\Windows\CurrentVersion\Uninstall\* |
Select-Object DisplayName, ModifyPath | Where-Object {$_.DisplayName -eq 'VMware Horizon
Agent'} | Format-Table –AutoSizeSortie :
DisplayName ModifyPath
VMware Horizon Agent MsiExec.exe /I{A17DD662-DFB3-4997-9C0F-4E687A300111}
L'exemple suivant modifie et supprime le composant USB d'une installation existante : VMware-Horizon-Agent-x86-YYMM-y.y.y-xxxxxx.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 : VMware-Horizon-Agent-x86-YYMM-y.y.y-xxxxxx.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 : VMware-Horizon-Agent-x86-YYMM-y.y.y-xxxxxx.exe /s /v"/qn ADDLOCAL=SerialPortRedirection,ScannerRedirection”
| 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 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 |
| V4V | Horizon Monitoring Service Agent | Oui |
| Carte à puce | Carte à puce Cette fonctionnalité n'est pas installée par défaut dans une installation interactive. |
Non |
| VmwVaudio | VMware Audio (pilote audio virtuel) | Oui |
| VmwVidd | Pilote d'affichage indirect VMware | Oui
Note : VmwVidd est installé et marqué comme local dans le registre uniquement si :
VmwVidd est installé et défini comme Absent dans le registre dans Windows Server 2019 (version 1809) standard et le centre de données avec le rôle RDS. VmwVidd sera installé et défini comme Local dans le registre dans Windows Server 2022 avec le rôle RDS. |
| 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 | VMware Integrated Printing | Oui |
| PSG | Cette fonctionnalité définit une entrée de registre qui indique au serveur de connexion si Horizon Agent utilise IPv4 ou IPv6. | Oui |
