16. April 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

Im Folgenden finden Sie eine Beispielausgabe (die GUID zwischen { und } unterscheidet sich je nach Agent-Build im System).


DisplayName        ModifyPath
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 der Produktseite in 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

Öffnen Sie auf der virtuellen Maschine oder auf einem physischen Computer eine Windows-Eingabeaufforderung. 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.

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"

Das folgende Beispiel installiert Horizon Agent auf einem nicht verwalteten Computer und registriert den Desktop bei dem angegebenen Verbindungsserver cs1.companydomain.com. Das Installationsprogramm installiert zudem die Komponenten Core, Horizon Blast, PCoIP, Unity Touch, PSG, Integrated Printing und USB-Umleitung.

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"

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 eine durch Produktcode gesteuerte Befehlszeile (ersetzen Sie Ihren tatsächlichen {GUID}-Wert): msiexec.exe /I{A17DD662-DFB3-4997-9C0F-4E687A300111} /qn REMOVE=USB

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 eine durch Produktcode gesteuerte Befehlszeile (ersetzen Sie Ihren tatsächlichen {GUID}-Wert): msiexec.exe /I{A17DD662-DFB3-4997-9C0F-4E687A300111} /qn ADDLOCAL=HelpDesk REMOVE=PerfTracker

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 eine durch Produktcode gesteuerte Befehlszeile (ersetzen Sie Ihren tatsächlichen {GUID}-Wert): msiexec.exe /I{A17DD662-DFB3-4997-9C0F-4E687A300111} /qn ADDLOCAL=SerialPortRedirection,ScannerRedirection

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.

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

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.
Öffnen Sie auf der virtuellen Maschine oder dem physischen Computer eine Windows-Eingabeaufforderung und geben Sie Folgendes ein (unter Verwendung des Namens der vorhandenen Agent-Installationsdatei agent-installer.exe und des Dateipfads der Datei „agent-settings.txt“).

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

Beispiel:

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

War diese Seite hilfreich?