Sie können spezifische Eigenschaften einschließen, wenn Sie eine Hintergrundinstallation von Horizon Agent für Windows über die Befehlszeile durchführen. Sie müssen das Format PROPERTY=value verwenden, damit Microsoft Windows Installer (MSI) die Eigenschaften und Werte interpretieren kann. Bei einem unbeaufsichtigten Upgrade werden die gleichen Installationsbefehle verwendet. Sie können die bereits installierten Horizon Agent-Komponenten ebenfalls unbeaufsichtigt ändern.
Die folgende Tabelle enthält die Eigenschaften für die unbeaufsichtigte Installation von Horizon Agent, die Sie in der Befehlszeile verwenden können.
MSI-Eigenschaften für die unbeaufsichtigte Installation von Horizon Agent
| MSI-Eigenschaft | Beschreibung | Standardwert |
|---|---|---|
| ENABLE_UNC_REDIRECTION | Legen Sie fest, ob die Funktion „UNC-Pfadumleitung“ installiert werden soll. Bei Verwendung des Werts 1 wird die Funktion installiert. Sie müssen mithilfe der Gruppenrichtlinieneinstellungen festlegen, welche UNCs umgeleitet werden sollen. Weitere Informationen finden Sie unter „Konfigurieren der UNC-Pfadumleitung“ im Dokument Horizon-Remote-Desktopfunktionen und GPOs. Diese MSI-Eigenschaft ist optional. | 0 |
| HORIZON_MONITOR_ENABLED | Gibt an, ob der Horizon-Überwachungsmodus aktiviert oder deaktiviert werden soll. Dieses Flag funktioniert nur, wenn Horizon Cloud Service – next-gen in Ihrer Umgebung installiert ist. Der Wert 1 aktiviert den Horizon-Überwachungsmodus. Der Wert 0 deaktiviert den Horizon-Überwachungsmodus. | 0 |
| IGNORE_DOTNET_CHECK | Legt fest, ob das Installationsprogramm eine .NET-Mindestversion überprüft. Wenn der Horizon Performance Tracker ausgewählt ist, führt das Installationsprogramm standardmäßig eine Vorabprüfung durch, um zu bestätigen, dass .NET 4.6.2 oder höher installiert ist, und hält den Installationsvorgang an, falls dies nicht der Fall ist. Mit dem Wert 1 wird diese Vorabprüfung abgebrochen. Mit dem Wert 0 kann die Vorabprüfung fortgesetzt werden. | 0 |
| INSTALLDIR | Pfad und Ordner, in dem die Horizon Agent-Software installiert ist. Beispiel:
INSTALLDIR=""D:\abc\my folder""
Die zweifach gesetzten doppelten Anführungszeichen um den Pfad sorgen dafür, dass das MSI-Installationsprogramm das Leerzeichen im Pfad ignoriert.
Diese MSI-Eigenschaft ist optional. | Horizon Agent wird im Ordner %ProgramFiles% structure. installiert |
| RDP_CHOICE | Legt fest, ob RDP (Remote Desktop Protocol) auf dem Desktop aktiviert werden soll. Mit dem Wert 1 wird RDP aktiviert. Mit dem Wert 0 wird die RDP-Einstellung deaktiviert gelassen. Diese MSI-Eigenschaft ist optional. | 1 |
| SUPPRESS_RUNONCE_CHECK | Ignoriert ausstehende Windows Update-Aufgaben, die für den nächsten Neustart des Betriebssystems in den Schlüsseln HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\RunOnce und RunOnceEx geplant sind. Die Verwendung dieses Kennzeichens ermöglicht eine parallele Installation. Das Ergebnis der Installation kann aber abweichen, wenn die System-Updates Auswirkungen auf die Laufzeitabhängigkeiten von Horizon Agent haben.
Diese MSI-Eigenschaft ist optional. | Keine |
| URL_FILTERING_ENABLED | Gibt an, ob die URL-Inhaltsumleitung installiert werden soll. Bei Verwendung des Werts 1 wird die Funktion installiert. Sie müssen mithilfe der Gruppenrichtlinieneinstellungen festlegen, welche URLs umgeleitet werden sollen. Weitere Informationen finden Sie unter „Konfigurieren der URL-Inhaltsumleitung“ im Dokument Horizon-Remote-Desktopfunktionen und GPOs. Diese MSI-Eigenschaft ist optional. | 0 |
| VDM_SKIP_BROKER_REGISTRATION | Mit dem Wert 1 werden nicht verwaltete Desktops übersprungen. | Keine |
| VDM_VC_MANAGED_AGENT | Legt fest, ob vCenter Server die virtuelle Maschine verwaltet, auf der Horizon Agent installiert ist. Mit dem Wert 1 wird der Desktop als von vCenter Server verwaltete virtuelle Maschine konfiguriert. Mit dem Wert 0 wird der Desktop ohne Verwaltung durch vCenter Server konfiguriert. Diese MSI-Eigenschaft ist erforderlich. Hinweis: Die Reparaturoption des Installationsprogramms wird nicht für eine nicht verwaltete Installation unterstützt. Die Reparatur einer solchen Installation führt zu einer Installation eines verwalteten Horizon Agent. | Keine |
| VDM_REINSTALL | Gibt eine kommagetrennte Liste von bereits installierten Funktionen an, die neu installiert werden sollen (nur im unbeaufsichtigten Modus anwendbar). | Keine |
| VDM_REINSTALLMODE | Eine Zeichenfolge mit Buchstaben, die die Art der durchzuführenden Neuinstallation angibt (nur im unbeaufsichtigten Modus anwendbar). Weitere Informationen zu den zu verwendenden Optionen finden Sie unter https://learn.microsoft.com/de-de/windows/win32/msi/reinstallmode. | Keine |
| VDM_SERVER_NAME | Hostname oder IP-Adresse der Verbindungsserver-Instanz, auf der das Horizon Agent-Installationsprogramm einen nicht verwalteten Desktop registriert. Diese Eigenschaft gilt nur für nicht verwaltete Desktops. Beispiel:
VDM_SERVER_NAME=10.123.01.01
Diese MSI-Eigenschaft ist für nicht verwaltete Desktops erforderlich.
Verwenden Sie diese MSI-Eigenschaft nicht für virtuelle Desktops, die von vCenter Server verwaltet werden. | Keine |
| VDM_SERVER_USERNAME | Der Benutzername des Administrators auf der Verbindungsserver-Instanz. Diese MSI-Eigenschaft gilt nur für nicht verwaltete Desktops. Beispiel:
VDM_SERVER_USERNAME=domain\username
Diese MSI-Eigenschaft ist für nicht verwaltete Desktops erforderlich.
Verwenden Sie diese MSI-Eigenschaft nicht für virtuelle Desktops, die von vCenter Server verwaltet werden. | Keine |
| VDM_SERVER_PASSWORD | Kennwort der Verbindungsserver-Administratorbenutzers. Beispiel:
VDM_SERVER_PASSWORD=secret
Diese MSI-Eigenschaft ist für nicht verwaltete Desktops erforderlich.
Verwenden Sie diese MSI-Eigenschaft nicht für virtuelle Desktops, die von vCenter Server verwaltet werden. | Keine |
| VDM_IP_PROTOCOL_USAGE | Gibt die von Horizon Agent verwendete IP-Version an. Gültige Werte sind IPv4 und IPv6. | IPv4 |
| VDM_FIPS_ENABLED | Gibt an, ob der FIPS-Modus aktiviert werden soll. Der Wert 1 aktiviert den FIPS-Modus. Der Wert 0 deaktiviert den FIPS-Modus. Wenn diese Eigenschaft auf 1 festgelegt wurde und sich Windows nicht im FIPS-Modus befindet, wird der Installationsvorgang beendet. | 0 |
| VDM_FORCE_DESKTOP_AGENT | Wenn Sie Horizon Agent auf einer Windows Server-Maschine installieren und als Einzelbenutzer-Horizon-Desktop anstatt als RDS-Host konfigurieren, legen Sie den Wert auf 1 fest. Diese Anforderung gilt für von vCenter Server verwaltete Maschinen und für nicht verwaltete Maschinen. Legen Sie für Gäste, die keine Windows Server-Gäste sind und die Anwendungssitzungen hosten, den Wert auf 0 fest. Diese MSI-Eigenschaft ist optional. | 0 |
In einem Befehl für die unbeaufsichtigte Installation können Sie die Eigenschaft ADDLOCAL zum Festlegen von Optionen verwenden, die das Horizon Agent-Installationsprogramm konfiguriert.
Die folgende Tabelle zeigt die Horizon Agent-Optionen, die Sie über die Befehlszeile eingeben können. Für diese Optionen gibt es entsprechende Setup-Optionen, die Sie bei einer interaktiven Installation deaktivieren bzw. aktivieren können.
Wenn Sie nicht die Eigenschaft ADDLOCAL an der Befehlszeile eingeben, installiert Horizon Agent alle für interaktive Installationen standardmäßig vorgesehenen Optionen, wenn diese auf dem Gastbetriebssystem unterstützt werden. Bei der Verwendung von ADDLOCAL=ALL installiert Horizon Agent die gesamten folgenden Optionen sowohl standardmäßig als auch nicht standardmäßig, wenn diese auf dem Gastbetriebssystem unterstützt werden.
Weitere Informationen finden Sie im Tabelleneintrag ADDLOCAL in Befehlszeilenoptionen für Microsoft Windows Installer.
Wenn Sie mit ADDLOCAL die Funktionen einzeln angeben (Sie müssen ADDLOCAL=ALL nicht festlegen), müssen Sie immer Core angeben.
Sie können Funktionen mithilfe der ADDLOCAL- und REMOVE-MSI-Eigenschaften ändern. Verwenden Sie den folgenden PowerShell-Befehl, um die Registrierung der installierten Komponenten auf dem System, auf dem Horizon Agent installiert ist, für die Basisbefehlszeile ModifyPath 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}
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 ändert und entfernt die USB-Geräte aus einer vorhandenen Installation: agent-installer.exe /s /v"/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"
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"
Optionen für die unbeaufsichtigte Horizon Agent-Installation und benutzerdefinierte Setup-Optionen bei einer interaktiven Installation
| Option für die unbeaufsichtigte Installation | Benutzerdefinierte Setup-Option in einer interaktiven Installation | Wird standardmäßig interaktiv oder bei Nichtverwendung von ADDLOCAL installiert |
|---|---|---|
| Core | Die Horizon Agent-Hauptfunktionen. Wenn Sie ADDLOCAL=ALL angeben, werden alle Core-Funktionen installiert. | Ja |
| USB | USB-Umleitung | Nein |
| NGVC | Instant-Clone-Agent | Nein |
| RTAV | Echtzeit-Audio/Video | Ja |
| ClientDriveRedirection | Clientlaufwerksumleitung | Ja |
| SerialPortRedirection | Umleitung für seriellen Port | Nein |
| ScannerRedirection | Scannerumleitung | Nein |
| GEOREDIR | Geolocation-Umleitung | Nein |
| V4V | Horizon Monitoring Service Agent | Ja |
| SmartCard | Smartcard Standardmäßig wird diese Funktion nicht in einer interaktiven Installation installiert. | Nein |
| Wenden Sie sich an den Omnissa-Support, um den für Ihre Horizon-Version geeigneten Optionsnamen zu erhalten. | Audio (virtueller Audio-Treiber) | Ja |
| Wenden Sie sich an den Omnissa-Support, um den für Ihre Horizon-Version geeigneten Optionsnamen zu erhalten. | Indirekter Anzeigetreiber | Ja
Hinweis: Diese Option wird nur dann installiert und in der Registrierung als „Lokal“ markiert, wenn:
|
| TSMMR | Windows Media-Multimedia-Umleitung (MMR) | Ja |
| RDP | Aktiviert das RDP-Protokoll in der Registrierung, wenn Sie die RDP_CHOICE=1-Eigenschaft in der Befehlszeile verwenden oder wenn Sie RDP als Standardanzeigeprotokoll für das Erstellen oder Bearbeiten eines Desktop-Pools ausgewählt haben. Diese Funktion wird bei interaktiven Installationen nicht angezeigt. | Ja |
| RDSH3D | 3D-Rendering auf RDS-Hosts | Nein |
| BlastUDP | UDP-Transportunterstützung für Blast | Ja |
| SdoSensor | SDO-Sensor-Umleitung | Nein |
| PerfTracker | Horizon Performance Tracker | Nein |
| HelpDesk | Horizon Help Desk Tool | Ja |
| PrintRedir | Integrated Printing | Ja |
| PSG | Diese Funktion fügt einen Registrierungseintrag ein, der dem Verbindungsserver übermittelt, ob Horizon Agent IPv4 oder IPv6 verwendet. | Ja |
War diese Seite hilfreich?