Skip to main content

8. Mai 2026

Unbeaufsichtigte Installation von Omnissa Horizon Agent für Windows

Sie können die Microsoft Windows Installer-Funktion (MSI) für die unbeaufsichtigte Installation dazu verwenden, Horizon Agent auf mehreren virtuellen Windows-Maschinen oder physischen Computern zu installieren. Bei einer unbeaufsichtigten Installation müssen Sie nicht auf Eingabeaufforderungen des Assistenten reagieren. Bei einem unbeaufsichtigten Upgrade werden die gleichen Installationsbefehle verwendet. Sie können die bereits installierten Horizon Agent-Komponenten ebenfalls unbeaufsichtigt ändern.

Sie können eine unbeaufsichtigte Installation durchführen, indem Sie Parameter manuell in der Befehlszeile eingeben oder eine Einstellungsdatei verwenden.

Informationen zur unbeaufsichtigten Installation

Die unbeaufsichtigte Installation ermöglicht eine effiziente Bereitstellung von Horizon 8-Komponenten in einem großen Unternehmen.

Wenn Sie nicht alle Funktionen installieren möchten, die automatisch oder standardmäßig installiert werden, können Sie die MSI-Eigenschaft ADDLOCAL verwenden, um bestimmte Setup-Optionen und Funktionen selektiv zu installieren. Ausführliche Informationen zur ADDLOCAL-Eigenschaft finden Sie in der Tabelle unter Befehlszeilenoptionen für Microsoft Windows Installer.

Sie können Funktionen mithilfe der ADDLOCAL- und REMOVE-MSI-Eigenschaften ändern.

Sie können den folgenden PowerShell-Befehl verwenden, um die Registrierung der installierten Komponenten auf dem System, auf dem Horizon Agent installiert ist, für die Basisbefehlszeile ModifyPath zu anzufordern:


Get-ItemProperty HKLM:\Software\Microsoft\Windows\CurrentVersion\Uninstall\* | Select-Object DisplayName, ModifyPath | 
Where-Object {$_.DisplayName -like '*Horizon Agent*'} | Format-Table –AutoSize

Die Ausgabe:


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

Voraussetzungen

  • Stellen Sie sicher, dass Sie Active Directory vorbereitet haben. Weitere Informationen finden Sie unter Horizon 8-Installation und -Upgrade.

  • Bereiten Sie das Gastbetriebssystem für die Desktop-Bereitstellung vor. Siehe Vorbereiten eines Gastbetriebssystems für die Remote-Desktop-Bereitstellung.

  • Um Windows Server als Einzelsitzungs-Remote-Desktop oder als RDSH-Host zu verwenden, führen Sie die in Vorbereiten von Windows Server-Betriebssystemen für Desktop-Verwendung beschriebenen Schritte aus.

    Hinweis: Das Horizon Agent-Installationsprogramm installiert im unbeaufsichtigten Modus nicht automatisch eine Rolle. Wenn Sie den RDS-Modus verwenden möchten, installieren Sie die RDSH-Rolle im Vorfeld auf dem System.

  • Ist auf der Maschine das Microsoft Visual C++ Redistributable-Paket installiert, stellen Sie sicher, dass die Version des Pakets 2005 SP1 oder höher ist. Wenn das Paket die Version 2005 oder früher aufweist, können Sie das Paket entweder aktualisieren oder deinstallieren.

  • Laden Sie die Installationsdatei für Horizon Agent von Omnissa Customer Connect herunter.

    Der Dateiname des Installationsprogramms lautet Horizon-Agent-x86-YYMM-y.y.y-xxxxxx.exe, wobei YYMM die Marketingversionsnummer, y.y.y die interne Versionsnummer und xxxxxx die Build-Nummer ist.

  • Stellen Sie sicher, dass Sie auf der virtuellen Maschine oder auf dem physischen Computer über Administratorberechtigungen verfügen.

  • Machen Sie sich mit den benutzerdefinierten Setup-Optionen für Horizon Agent vertraut. Siehe Benutzerdefinierte Setup-Optionen für Horizon Agent für Windows.

  • Machen Sie sich mit den MSI-Befehlszeilenoptionen vertraut. Weitere Informationen finden Sie unter Microsoft Windows Installer-Befehlszeilenoptionen.

  • Machen Sie sich mit den verfügbaren Eigenschaften für die unbeaufsichtigte Installation von Horizon Agent vertraut. Siehe Eigenschaften für die Hintergrundinstallation von Horizon Agent für Windows.

  • Machen Sie sich mit den TCP-Ports vertraut, die das Horizon Agent-Installationsprogramm in der Firewall öffnet. Weitere Informationen finden Sie im Dokument Horizon-Übersicht und Bereitstellungsplanung.

  • Stellen Sie sicher, dass die neuesten Windows Update-Patches auf den Gastbetriebssystemen installiert sind, auf denen Sie Horizon Agent unbeaufsichtigt installieren möchten. In bestimmten Fällen ist möglicherweise eine interaktive Installation durch einen Administrator erforderlich, um ausstehende Windows Update-Patches auszuführen. Stellen Sie sicher, dass alle Vorgänge im Betriebssystem und nachfolgende Neustarts abgeschlossen wurden.

Unbeaufsichtigte Installation von Horizon Agent durch Eingabe von Parametern in der Befehlszeile

Sie können diese Befehle in einer Windows-Eingabeaufforderung auf der virtuellen Maschine oder dem physischen PC ausführen.

Hinweis: Wenn Sie Horizon Agent auf einem Windows Server-Computer installieren und den Computer als Horizon-Desktop für Einzelbenutzer statt als RDS-Host konfigurieren möchten, müssen Sie im Installationsbefehl die Eigenschaftseinstellung VDM_FORCE_DESKTOP_AGENT=1 angeben. Diese Anforderung gilt für Computer, die von vCenter Server verwaltet werden, und für nicht verwaltete Computer.

Hinweis: In den folgenden Beispielen steht der Name agent-installer.exe für die heruntergeladene Installationsdatei. Ersetzen Sie den Namen der von Ihnen verwendeten exe-Datei des Installationsprogramms.

Beispiel 1

Das folgende Beispiel installiert Horizon Agent mit den Komponenten Core, Horizon Blast, PCoIP, Unity Touch, PSG, USB-Umleitung und Echtzeit-Audio-/Video.

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

Beispiel 2

Im nachstehenden Beispiel wird Horizon Agent auf einem nicht verwalteten Computer installiert. Das Installationsprogramm installiert zudem die Komponenten Core, Horizon Blast, PCoIP, Unity Touch, PSG, Integrated Printing und USB-Umleitung. Schließen Sie die Installation auf dem Bildschirm Beim Horizon Connection Server registrieren basierend auf einem der folgenden Kopplungs-/Registrierungsmodi ab.

  1. Geben Sie den Namen eines Horizon Connection Servers und die Anmeldedaten ein: Geben Sie im Dialogfeld den CS-Hostnamen und die HzE-Administratoranmeldedaten ein.

    • Option für die unbeaufsichtigte Installation: VDM_PAIRING_MECHANISM=1
  2. Automatische Erkennung des Horizon Connection Servers: Wählen Sie diese Option aus, um automatisch zu ermitteln und mit dem Bildschirm Bereit zur Installation fortzufahren.

    • Option für die unbeaufsichtigte Installation: VDM_PAIRING_MECHANISM=2
  3. Geben Sie den Namen des Pods ein: Geben Sie den Namen des Pods ein, mit dem der Computer verbunden wird. Fahren Sie mit dem Bildschirm Bereit zur Installation fort.

    • Option für die unbeaufsichtigte Installation: VDM_PAIRING_MECHANISM=3 VDM_POD_NAME=<POD name>

Beispiel 3

Das folgende Beispiel ändert und entfernt die USB-Geräte aus einer vorhandenen Installation:

agent-installer.exe /s /v "/qn REMOVE=USB"

Beispiel für durch Produktcode gesteuerte Befehlszeile: msiexec.exe /I{A17DD662-DFB3-4997-9C0F-4E687A300111} /qn REMOVE=USB

Beispiel 4

Das folgende Beispiel ändert die Installation des Agents durch Ersetzen von Horizon Performance Tracker durch das Horizon Help Desk Tool: agent-installer.exe /s /v "/qn ADDLOCAL=HelpDesk REMOVE=PerfTracker”

Beispiel für durch Produktcode gesteuerte Befehlszeile: msiexec.exe /I{A17DD662-DFB3-4997-9C0F-4E687A300111} /qn ADDLOCAL=HelpDesk REMOVE=PerfTracker

Beispiel 5

Das folgende Beispiel ändert die Installation des Agent durch Hinzufügen des seriellen Ports und der Scannerumleitung: agent-installer.exe /s /v "/qn ADDLOCAL=SerialPortRedirection,ScannerRedirection”

Beispiel für durch Produktcode gesteuerte Befehlszeile: msiexec.exe /I{A17DD662-DFB3-4997-9C0F-4E687A300111} /qn ADDLOCAL=SerialPortRedirection,ScannerRedirection

Wenn die Installation abgeschlossen ist

Wenn die virtuelle Maschine nach Abschluss der Installation über mehrere Netzwerkkarten verfügt, konfigurieren Sie das von Horizon Agent verwendete Subnetz. Siehe Konfigurieren einer virtuellen Maschine mit mehreren Netzwerkkarten für Horizon Agent.

Unbeaufsichtigte Installation von Horizon Agent mithilfe einer Einstellungsdatei

  1. Erstellen Sie eine Textdatei mit den Parametern, die Sie für die Installation verwenden möchten.

    • Die Datei kann sich entweder auf einem lokalen oder Netzlaufwerk befinden. Die Verwendung zugeordneter Laufwerke wird ebenfalls unterstützt.
    • Die Datei kann eine beliebige nur aus Text bestehende Erweiterung aufweisen.
    • Jeder Parameter muss sich in einer eigenen Zeile befinden.
    • Jeder andere Text (neben den Parametern selbst) muss mit einem Hash-Zeichen (#) am Anfang der Zeile auskommentiert werden.
    • Sowohl Leerzeichen als auch leere Zeilenumbrüche sind in der Datei zulässig. Hinweis: Wenn Sie Horizon Agent auf einem Windows Server-Computer installieren und den Computer als Horizon-Desktop für Einzelbenutzer und nicht als RDS-Host konfigurieren möchten, müssen Sie im Installationsbefehl die Eigenschaft VDM_FORCE_DESKTOP_AGENT=1 in der Einstellungsdatei angeben. Diese Anforderung gilt für Computer, die von vCenter Server verwaltet werden, und für nicht verwaltete Computer.

    Achtung: Das Installationsprogramm verarbeitet keine Kennwörter. Wenn Ihre Datei eine bekannte Kennworteigenschaft wie VDM_SERVER_PASSWORD enthält, kann das Installationsprogramm die Datei nicht analysieren und gibt einen Fehler zurück. Zur Berücksichtigung eines Kennworts müssen Sie es manuell in der Befehlszeile eingeben. Wenn Sie ein Kennwort auf diese Weise eingeben, wird es nur einmal übergeben und nicht protokolliert.

    Beispieldatei: C:\Users\demo\agent-settings.txt

  VDM_VC_MANAGED_AGENT=0

   VDM_SERVER_NAME=cs1.companydomain.com

   VDM_SERVER_USERNAME=admin.companydomain.com

   ADDLOCAL=HelpDesk

   REMOVE=PerfTracker
  1. Öffnen Sie auf der virtuellen Maschine oder dem physischen Computer eine Windows-Eingabeaufforderung und geben Sie Folgendes ein: Verwenden Sie den Namen der vorhandenen agent-installer.exe Agent-Installationsdatei und den Dateipfad zu Ihrer agent-settings.txt-Datei.

    Beispiel:

    agent-installer.exe /s /v "/qn SETTINGS_FILE=C:\Users\demo\agent-settings.txt VDM_SERVER_PASSWORD=secret"

Wenn die Installation abgeschlossen ist

Wenn die virtuelle Maschine nach Abschluss der Installation über mehrere Netzwerkkarten verfügt, konfigurieren Sie das von Horizon Agent verwendete Subnetz. Siehe Konfigurieren einer virtuellen Maschine mit mehreren Netzwerkkarten für Horizon Agent.

War diese Seite hilfreich?

Feedback zu diesem Thema geben

War dieses Thema hilfreich?

Bitte geben Sie keine personenbezogenen oder vertraulichen Daten an.

Link wird erstellt…