Skip to main content

16 avril 2026

Installation d'Omnissa Horizon Agent pour Windows en mode silencieux

Vous pouvez utiliser la fonction d'installation silencieuse de MSI (Microsoft Windows Installer) pour installer Horizon Agent sur plusieurs machines virtuelles ou ordinateurs physiques Windows. Dans une installation silencieuse, vous n'avez pas à répondre à des invites d'assistant. Une mise à niveau silencieuse utilise les mêmes commandes d'installation. Vous pouvez également modifier les composants d'Horizon Agent installés en silence.

Vous pouvez effectuer une installation silencieuse en entrant les paramètres manuellement sur la ligne de commande ou en utilisant un fichier de paramètres.

À propos de l'installation silencieuse

Avec l'installation silencieuse, vous pouvez déployer efficacement des composants Horizon 8 dans une grande entreprise.

Si vous ne souhaitez pas installer toutes les fonctionnalités installées automatiquement ou par défaut, vous pouvez utiliser la propriété MSI ADDLOCAL pour sélectionner des fonctionnalités et des options de configuration individuelles à installer. Pour plus d'informations sur la propriété ADDLOCAL, reportez-vous au tableau dans Options de ligne de commande du programme d'installation de Microsoft Windows.

Vous pouvez modifier les fonctionnalités en utilisant les propriétés MSI ADDLOCAL et REMOVE.

Vous pouvez utiliser 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

Voici un exemple de sortie (le GUID entre { et } sera différent en fonction de la build de l'agent dans le système).


DisplayName        ModifyPath
Horizon Agent      MsiExec.exe /I{A17DD662-DFB3-4997-9C0F-4E687A300111}

Conditions préalables

  • Vérifiez que vous avez préparé Active Directory. Reportez-vous au document Installation et mise à niveau d'Horizon 8.

  • Préparez le système d'exploitation invité au déploiement du poste de travail. Reportez-vous à la section Préparer un système d'exploitation invité pour le déploiement de postes de travail distants.

  • Pour utiliser Windows Server en tant que poste de travail distant à session unique ou en tant qu'hôte RDSH, procédez comme décrit dans la section Préparer les systèmes d'exploitation Windows Server pour l'utilisationdu poste de travail.

    Remarque : le programme d'installation d'Horizon Agent n'installe pas automatiquement un rôle en mode silencieux. Si vous souhaitez utiliser le mode RDS, préinstallez le rôle RDSH sur le système.

  • Si le module Microsoft Visual C++ Redistributable est installé sur la machine, vérifiez que la version du module est 2005 SP1 ou version ultérieure. Si la version du module est 2005 ou antérieure, vous pouvez effectuer la mise à niveau ou désinstaller le module.

  • Téléchargez le fichier du programme d'installation d'Horizon Agent à partir d'Omnissa Customer Connect.

Le nom de fichier du programme d'installation suit le modèle Horizon-Agent-x86-YYMM-y.y.y-xxxxxx.exe, dans lequel YYMM est le numéro de version marketing, y.y.y est le numéro de version interne et xxxxxx est le numéro de build.

  • Vérifiez que vous disposez de droits d'administration sur la machine virtuelle ou l'ordinateur physique.
  • Familiarisez-vous avec les options d'installation personnalisée d'Horizon Agent. Reportez-vous à la section Options d'installation personnalisée pour Horizon Agent pour Windows.
  • Familiarisez-vous avec les options de ligne de commande du programme d'installation MSI. Reportez-vous à la section Options de ligne de commande de Microsoft Windows Installer.
  • Familiarisez-vous avec les propriétés d'installation silencieuse disponibles avec Horizon Agent. Reportez-vous à la section Propriétés de l'installation silencieuse pour Horizon Agent pour Windows.
  • Familiarisez-vous avec les ports TCP que le programme d'installation d'Horizon Agent ouvre sur le pare-feu. Pour plus d'informations, reportez-vous au document Présentation et planification du déploiement d'Horizon.
  • Vérifiez que les correctifs les plus récents de Windows Update sont installés sur les systèmes d'exploitation invités sur lesquels vous prévoyez d'installer Horizon Agent de manière silencieuse. Dans certains cas, une installation interactive effectuée par un administrateur peut être nécessaire pour exécuter les correctifs en attente de Windows Update. Vérifiez que toutes les opérations du système d'exploitation et tous les redémarrages successifs sont terminés.

Installer Horizon Agent en mode silencieux en entrant des paramètres sur la ligne de commande

  1. Ouvrez une invite de commande Windows sur la machine virtuelle ou l'ordinateur physique. Remarque : dans les exemples suivants, le nom agent-installer.exe représente le fichier du programme d'installation téléchargé. Remplacez le nom du fichier exe du programme d'installation que vous utilisez.

    L'exemple suivant installe Horizon Agent avec les composants Core, Horizon Blast, PCoIP, Unity Touch, PSG, Redirection USB et les composants audio/vidéo en temps réel.

    agent-installer.exe /s /v "/qn VDM_VC_MANAGED_AGENT=1 ADDLOCAL=Core,USB,RTAV"

    L'exemple suivant installe Horizon Agent sur un ordinateur non géré et enregistre le poste de travail auprès du Serveur de connexion spécifié, cs1.companydomain.com. De plus, le programme d'installation installe les composants Core, Horizon Blast, PCoIP, Unity Touch, PSG, Integrated Printing et Redirection USB.

    agent-installer.exe /s /v "/qn VDM_VC_MANAGED_AGENT=0 VDM_SERVER_NAME=cs1.companydomain.com VDM_SERVER_USERNAME=admin.companydomain.com VDM_SERVER_PASSWORD=secret ADDLOCAL=Core,PrintRedir,USB"

    L'exemple suivant modifie et supprime le composant USB d'une installation existante : agent-installer.exe /s /v "/qn REMOVE=USB"

    Exemple de ligne de commande basée sur le code produit (remplacez la valeur {GUID} par votre valeur réelle) : msiexec.exe /I{A17DD662-DFB3-4997-9C0F-4E687A300111} /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”

    Exemple de ligne de commande basée sur le code produit (remplacez la valeur {GUID} par votre valeur réelle) : msiexec.exe /I{A17DD662-DFB3-4997-9C0F-4E687A300111} /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”

    Exemple de ligne de commande basée sur le code produit (remplacez la valeur {GUID} par votre valeur réelle) : msiexec.exe /I{A17DD662-DFB3-4997-9C0F-4E687A300111} /qn ADDLOCAL=SerialPortRedirection,ScannerRedirection

    Remarque : si vous installez Horizon Agent sur une machine Windows Server et que vous avez l'intention de configurer la machine en tant que poste de travail Horizon mono-utilisateur plutôt qu'en tant qu'hôte RDS, vous devez inclure la propriété VDM_FORCE_DESKTOP_AGENT=1 dans la commande d'installation. Cette condition s'applique aux machines gérées par vCenter Server, ainsi qu'aux machines non gérées.

Une fois l'installation terminée, si la machine virtuelle contient plusieurs cartes réseau, configurez le sous-réseau qu'Horizon Agent utilise. Reportez-vous à la section Configurer une machine virtuelle avec plusieurs cartes réseau pour Horizon Agent.

Installer Horizon Agent en mode silencieux à l'aide d'un fichier de paramètres

  1. Créez un fichier texte contenant les paramètres que vous souhaitez utiliser pour l'installation.

    • Le fichier peut être situé sur un lecteur local ou sur un lecteur réseau. L'utilisation de lecteurs mappés est également prise en charge.
    • Le fichier peut avoir n'importe quelle extension, mais doit être en texte uniquement.
    • Chaque paramètre doit se trouver sur sa propre ligne.
    • Tout autre texte (outre les paramètres eux-mêmes) doit être commenté à l'aide d'un signe de hachage (#) au début de la ligne.
    • Les espaces et les nouvelles lignes vides sont autorisés dans le fichier. Remarque : si vous installez Horizon Agent sur une machine Windows Server et que vous avez l'intention de configurer la machine en tant que poste de travail Horizon mono-utilisateur plutôt qu'en tant qu'hôte RDS, vous devez inclure la propriété VDM_FORCE_DESKTOP_AGENT=1 dans le fichier de paramètres. Cette condition s'applique aux machines gérées par vCenter Server, ainsi qu'aux machines non gérées.

    Avertissement : le programme d'installation ne traite pas les mots de passe. Si votre fichier inclut une propriété de mot de passe connue telle que VDM_SERVER_PASSWORD, le programme d'installation ne parvient pas à analyser le fichier et renvoie une erreur. Pour inclure un mot de passe, vous devez l'entrer manuellement sur la ligne de commande. Lorsque vous entrez un mot de passe de cette manière, il n'est transmis qu'une seule fois et n'est consigné nulle part.

  2. Ouvrez une invite de commande Windows sur la machine virtuelle ou sur l'ordinateur physique et entrez ce qui suit (en utilisant le nom agent-installer.exe du fichier du programme d'installation de l'agent que vous avez mis en place et le chemin d'accès à votre fichier agent-settings.txt).

    agent-installer.exe /v SETTINGS_FILE=<file path>

    Par exemple :

    agent-installer.exe /v SETTINGS_FILE=C:\Users\demo\agent-settings.txt

Une fois l'installation terminée, si la machine virtuelle contient plusieurs cartes réseau, configurez le sous-réseau qu'Horizon Agent utilise. Reportez-vous à la section Configurer une machine virtuelle avec plusieurs cartes réseau pour Horizon Agent.

Cette page vous a-t-elle été utile ?

Envoyer un commentaire sur cette rubrique

Cette rubrique vous a-t-elle été utile ?

N'indiquez aucune information personnelle ou confidentielle.

Génération du lien…