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.

Tableau 1. Propriétés MSI pour 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 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.

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 -eq 'VMware Horizon
        Agent'} | Format-Table –AutoSize
Sortie :
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”

Tableau 2. Options de l'installation silencieuse d'Horizon Agent et options de l'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 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 :
  • Le mode de poste de travail Windows Server est RS4 et versions ultérieures (build 17134 du SE, version 1803). or
  • Le serveur est à la version 19H1 et versions ultérieures (build 18362 du système d'exploitation, version 1903)

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