Skip to main content

31. März 2025

Ausführen von Omnissa Horizon Client über die Befehlszeile

Sie können Horizon Client von der Befehlszeile aus oder über Skripte ausführen. Sie sollten Horizon Client möglicherweise über die Befehlszeile ausführen, wenn Sie eine kioskbasierte Anwendung implementieren, die Endbenutzern Zugriff auf Remote-Desktop-Anwendungen gewährt.

Zum Ausführen von Horizon Client über die Befehlszeile verwenden Sie den ausführbaren Befehl mit demselben Namen wie die ausführbare Datei der Anwendung. Der ausführbare Befehl umfasst Optionen, die Sie angeben können, um das Verhalten von Horizon Client zu ändern.

Horizon Client-Befehlsverwendung

Die Syntax des ausführbaren Befehls steuert den Betrieb von Horizon Client.

Verwenden Sie den ausführbaren Befehl an einer Windows-Eingabeaufforderung mit dem folgenden Format.

[executable] [command_line_option [argument]] ...

Der Standardpfad zur ausführbaren Datei des ausführbaren Befehls ist vom Clientsystem abhängig. Sie können diesen Pfad auf dem Clientsystem zur Umgebungsvariable PATH hinzufügen.

In der folgenden Tabelle sind die Befehlszeilenoptionen aufgeführt, die mit dem ausführbaren Befehl verwendet werden können.

Befehlszeilenoptionen für Horizon Client
OptionBeschreibung
/?Zeigt die Liste der Befehlsoptionen an.
-appName application_nameGibt den Namen der veröffentlichten Anwendung an, der im Dialogfeld zur Desktop- und Anwendungsauswahl angezeigt wird. Hierbei handelt es sich um den Anzeigenamen, der für den Anwendungspool im Assistenten zur Poolerstellung angegeben wurde.
-appProtocol protocolLegt das Anzeigeprotokoll fest, das für die veröffentlichte Anwendung verwendet wird, falls verfügbar. Die gültigen Protokolle lauten wie folgt:
  • Blast
  • PCoIP
-appSessionReconnectionBehavior argumentLegt die Einstellung für das Wiederverbindungsverhalten von veröffentlichten Anwendungen fest. Die gültigen Argumente lauten wie folgt:
  • always
    Implementiert die Einstellung <strong>Neuverbindung zum Öffnen von Anwendungen automatisch herstellen</strong>.</li>
    
  • never
    Implementiert die Einstellung <strong>Vor Neuverbindung nicht fragen und nicht automatisch neu verbinden</strong>.</li>
    
  • ask
    Implementiert die Einstellung <strong>Vor Neuverbindung zum Öffnen von Anwendungen fragen</strong>.</li>
    
Wenn Sie diese Option verwenden, werden die Einstellungen für die Wiederverbindung von veröffentlichten Anwendungen in Horizon Client deaktiviert.
-args argumentGibt Befehlszeilenargumente zum Hinzufügen an, wenn eine veröffentlichte Anwendung gestartet wird. Zum Beispiel:
[executable] -serverURL
10.10.10.10 -appName "My Notepad++" -args "\"my new.txt\""
-connectUSBOnStartupWenn dies auf „true“ gesetzt ist, werden alle mit dem Host verbundenen USB-Geräte an den Remote-Desktop bzw. die veröffentlichte Anwendung umgeleitet. Diese Option wird bei Angabe der Option „-unattended“ für einen Remote-Desktop implizit festgelegt. Die Standardeinstellung ist „False“.
-connectUSBOnInsertBei der Festlegung auf „true“ wird ein USB-Gerät beim Anschließen des Geräts mit dem im Vordergrund angezeigten Remote-Desktop bzw. der veröffentlichten Anwendung verbunden. Diese Option wird bei Angabe der Option „-unattended“ für einen Remote-Desktop implizit festgelegt. Die Standardeinstellung ist „False“.
-desktopLayout window_sizeGibt an, wie das Remote-Desktop-Fenster angezeigt werden soll. Die gültigen Werte für die Fenstergröße lauten wie folgt:
  • fullscreen
    Vollbildanzeige.</li>
    
  • multimonitor
    Mehrfachmonitoranzeige.</li>
    
  • windowLarge
    Großes Fenster.</li>
    
  • windowSmall
    Kleines Fenster.</li>
    
  • length X width
    Benutzerdefinierte Größe, wie z. B. 800 x 600.</li>
    
-desktopName desktop_nameGibt den Namen des Remote-Desktops an, der im Dialogfeld zur Desktop- und Anwendungsauswahl angezeigt wird. Hierbei handelt es sich um den Anzeigenamen, der für den Pool im Assistenten zur Poolerstellung angegeben wurde. Wichtig: Geben Sie diese Option nicht für Clients im Kiosk-Modus an. Diese Option bleibt wirkungslos, wenn der Remote-Desktop im Kiosk-Modus ausgeführt wird. Im Kiosk-Modus wird die Verbindung zum ersten Remote-Desktop in der Liste der berechtigten Remote-Desktops hergestellt.
-desktopProtocol protocolGibt den Namen des zu verwendenden Anzeigeprotokolls an, der im Dialogfeld zur Desktop- und Anwendungsauswahl angezeigt wird. Die gültigen Anzeigeprotokolle lauten wie folgt:
  • Blast
  • PCoIP
  • RDP
-domainName domain_nameGibt die NETBIOS-Domäne an, die der Endbenutzer zur Anmeldung bei Horizon Client verwendet. Beispielsweise ist es sinnvoller, mycompany als mycompany.com zu verwenden.
-file file_pathGibt den Pfad einer Konfigurationsdatei mit zusätzlichen Befehlsoptionen und -argumenten an.
-hZeigt Hilfeoptionen an.
-hideClientAfterLaunchSessionBei Festlegung auf „true“ wird das Fenster für die Desktop- und Anwendungsauswahl ausgeblendet. Bei Festlegung auf „false“ wird das Fenster für die Desktop- und Anwendungsauswahl angezeigt.
-installShortcutsThenQuitVerwenden Sie diese Option, um Desktop- und Anwendungsverknüpfungen zu installieren, die auf dem-Server konfiguriert sind. Wenn Sie diese Option mit ausreichenden Informationen zur Serverauthentifizierung verwenden, stellt Horizon Client eine automatische Verbindung mit dem Server her, installiert die Verknüpfungen und wird dann beendet. Wenn die Serverauthentifizierung fehlschlägt, wird Horizon Client automatisch beendet. Um Verknüpfungen automatisch auf dem Clientsystem zu installieren, erstellen Sie ein Skript, das beim Start des Clientsystems ausgeführt wird. Zum Beispiel:
[executable] -serverURL serverurl -userName user -domainName domain 
-password password -installShortcutsThenQuit

[executable] -serverURL serverurl -logInAsCurrentUser true -installShortcutsThenQuit

Informationen zu vom Server erstellten Verknüpfungen finden Sie unter Konfigurieren von Verknüpfungsaktualisierungen auf Horizon Windows Client.
-languageId Locale_IDBietet Lokalisierungsunterstützung für verschiedene Sprachen in Horizon Client. Wenn eine Ressourcenbibliothek verfügbar ist, geben Sie die zu verwendende Gebietsschema-ID (Locale ID, LCID) an. Für Englisch (USA) geben Sie 0x409 ein.
-launchMinimizedStartet Horizon Client im minimierten Modus. Wenn Sie die Option „-appName“ oder „desktopName“ angeben, bleibt Horizon Client minimiert, bis die veröffentlichte Anwendung oder der Remote-Desktop gestartet wird, die bzw. der angegeben wurde. Sie können diese Option nicht mit der Option „-unattended“ oder „-nonInteractive“ verwenden.
-listMonitorsFührt die Indexwerte auf und zeigt die Layoutinformationen für die verbundenen Monitore an. Zum Beispiel:
1: (0, 0, 1920, 1200)
2: (1920, 0, 3840, 1200)
3: (-900, -410, 0, 1190)
Sie können diese Indexwerte in der Option -monitors verwenden.
-loginAsCurrentUserWenn hier „true“ angegeben ist, werden die Anmeldedaten des Endbenutzers, die dieser zur Anmeldung beim Clientsystem eingegeben hat, zur Anmeldung beim Server und schließlich beim Remote-Desktop verwendet. Die Standardeinstellung ist „False“.
-monitors"n[,n,n,n]"Gibt die Monitore an, die in einer Mehrfachmonitorumgebung verwendet werden sollen, wobei n der Indexwert eines Monitors ist. Sie können mit der Option „-listMonitors“ die Indexwerte der verbundenen Monitore bestimmen. Es lassen sich bis zu vier Indexwerte, durch Kommas getrennt, angeben. Zum Beispiel:
-monitors "1,2"
Diese Option ist nur wirksam, wenn für „-desktopLayout“ die Einstellung „multimonitor“ festgelegt ist.
-nonInteractiveUnterdrückt Fehlermeldungen beim Starten von Horizon Client über ein Skript. Diese Option wird bei Angabe der Option „-unattended“ implizit festgelegt. Hinweis: Wenn Sie sich bei einem Server im nicht interaktiven Modus anmelden, werden Sie nicht aufgefordert, Verknüpfungen (sofern verfügbar) für das Startmenü zu installieren. Die Verknüpfungen werden dann standardmäßig installiert.
-password passwordGibt das Kennwort an, das der Endbenutzer zur Anmeldung bei Horizon Client verwendet. Das Kennwort wird von der Befehlskonsole und von jedem Skripttool im Textformat weiterverarbeitet. Wenn Sie das Kennwort automatisch generieren, müssen Sie diese Option für Clients im Kiosk-Modus nicht angeben. Zur Erhöhung der Sicherheit sollten Sie diese Option nicht angeben. Benutzer können das Kennwort interaktiv eingeben.
-printEnvironmentInfoZeigt die IP-Adresse, die MAC-Adresse und den Maschinennamen des Clientgeräts an.
-serverURL connection_serverGibt die URL, die IP-Adresse oder den FQDN des Servers an.
-shutdownFährt alle Remote-Desktops und veröffentlichten Anwendungen sowie relevante Benutzeroberflächenkomponenten herunter.
-singleAutoConnectWenn der Benutzer nur für einen Remote-Desktop oder eine veröffentlichte Anwendung berechtigt ist, wird die Verbindung mit diesem Remote-Desktop oder dieser veröffentlichten Anwendung hergestellt, nachdem der Benutzer sich beim Server authentifiziert hat. So muss der Benutzer nicht einen Remote-Desktop oder eine veröffentlichte Anwendung aus einer Liste auswählen, die nur ein Element enthält.
-smartCardPIN PINGibt die PIN an, wenn ein Endbenutzer eine Smartcard zur Anmeldung einführt.
-usernameHint user_nameGibt den Kontonamen an, der als Benutzernamenhinweis verwendet werden soll.
-standaloneStartet eine zweite Instanz von Horizon Client, die eine Verbindung mit demselben oder einem anderen Server herstellen kann. Diese Option wird für die Abwärtskompatibilität unterstützt. Die Angabe von „-standalone“ ist nicht erforderlich, da dies das Standardverhalten für den Client ist. Für mehrere Remote-Desktop-Verbindungen zu demselben oder einem anderen Server wird der sichere Tunnel unterstützt. Hinweis: Die zweite Remote-Desktop-Verbindung hat möglicherweise keinen Zugriff auf die lokale Hardware, wie USB-Geräte, Smartcards, Drucker und mehrere Monitore.
-supportText file_nameGibt den vollständigen Pfad einer Textdatei an. Der Inhalt der Datei wird im Dialogfeld „Info“ angezeigt.
-unattendedStartet Horizon Client im nicht interaktiven Modus, der sich für Clients im Kiosk-Modus eignet. Sie müssen auch die folgenden Informationen angeben:
  • Der Kontoname des Clients, wenn dieser nicht über die MAC-Adresse des Clientgeräts generiert wurde. Der Name muss mit der Zeichenfolge „custom-“ oder einem alternativen Präfix beginnen, das Sie in ADAM konfiguriert haben.
  • Das Kennwort des Clients, wenn dieses nicht automatisch beim Einrichten des Clientkontos generiert wurde.
Über die Option „-unattended“ werden die Optionen „-nonInteractive“, „-connectUSBOnStartup“, „-connectUSBOnInsert“ und „-desktopLayout multimonitor“ implizit festgelegt.
-unauthenticatedAccessAccountLegt ein Benutzerkonto für einen nicht authentifizierten Zugriff zur anonymen Anmeldung beim Server fest, wenn der nicht authentifizierte Zugriff aktiviert ist. Wenn der nicht authentifizierte Zugriff nicht aktiviert ist, wird diese Option ignoriert. Beispiel:
[executable] -serverURL horizon.mycompany.com 
-unauthenticatedAccessEnabled true 
-unauthenticatedAccessAccount anonymous1
-unauthenticatedAccessEnabled Bei Festlegung auf „true“ wird der nicht authentifizierte Zugriff ermöglicht. Wenn der nicht authentifizierte Zugriff nicht verfügbar ist, kann der Client auf eine andere Authentifizierungsmethode zurückgreifen. Die Einstellung Nicht authentifizierter Zugriff wird in Horizon Client angezeigt, deaktiviert und ausgewählt. Bei Festlegung auf „true“ ist die Eingabe Ihrer Anmeldedaten für die Anmeldung bei Ihren Anwendungen und den Zugriff darauf erforderlich. Die Einstellung Nicht authentifizierter Zugriff ist in Horizon Client ausgeblendet und deaktiviert. Wenn Sie diese Option nicht festlegen, können Sie den nicht authentifizierten Zugriff in Horizon Client aktivieren. Die Einstellung Nicht authentifizierter Zugriff wird angezeigt, aktiviert und abgewählt.
-useExistingErmöglicht den Start mehrerer Remote-Desktops und veröffentlichter Anwendungen aus einer einzelnen Horizon Client-Sitzung. Wenn Sie diese Option festlegen, ermittelt Horizon Client, ob eine Sitzung mit dem gleichen Benutzernamen, der gleichen Domäne und der gleichen Server-URL bereits vorhanden ist. Ist dies der Fall, wird diese Sitzung wiederverwendet, anstatt eine neue zu erstellen. Im nachfolgend aufgeführten Befehl startet user-1 beispielsweise die Anwendung „Berechnung“, und eine neue Sitzung wird erstellt.
[executable] -userName user-1 -password secret 
-domainName domain -appName Calculator 
-serverURL horizon.mycompany.com -useExisting
Im nächsten Befehl startet user-1 die Paint-Anwendung mit dem gleichen Benutzernamen, der gleichen Domäne und der gleichen Server-URL, und es wird dieselbe Sitzung verwendet.
[executable] -userName user-1 -password secret 
-domainName domain -appName Paint 
-serverURL horizon.mycompany.com -useExisting
-userName user_nameGibt den Kontonamen an, den der Endbenutzer zur Anmeldung bei Horizon Client verwendet. Wenn Sie den Kontonamen aus der MAC-Adresse des Clientgeräts generieren, müssen Sie diese Option für Clients im Kiosk-Modus nicht angeben.

Mit Ausnahme von „-file“, „-languageId“, „-printEnvironmentInfo“, „-smartCardPIN“ und „-unattended“ können Sie alle Optionen über Active Directory-Gruppenrichtlinien angeben.

Hinweis: Gruppenrichtlinieneinstellungen haben Vorrang vor Einstellungen, die Sie über die Befehlszeile angeben. Bei den Befehlszeilenoptionen wird die Groß-/Kleinschreibung beachtet.

Horizon Client-Konfigurationsdatei

Sie können Befehlszeileninformationen für Horizon Client aus einer Konfigurationsdatei auslesen.

Sie können den Pfad der Konfigurationsdatei als Argument der Option -file file_path des ausführbaren Befehls angeben. Bei der Datei muss es sich um eine Unicode- (UTF-16) oder um eine ASCII-Textdatei handeln.

Beispiel einer Konfigurationsdatei für eine nicht interaktive Anwendung

Das folgende Beispiel zeigt die Inhalte einer Konfigurationsdatei für eine nicht interaktive Anwendung.

-serverURL https://horizon.yourcompany.com
-userName autouser
-password auto123
-domainName companydomain
-desktopName autodesktop
-nonInteractive

Beispiel einer Konfigurationsdatei für einen Client im Kioskmodus

Das folgende Beispiel zeigt einen Client im Kiosk-Modus, dessen Kontoname auf seiner MAC-Adresse basiert. Der Client verwendet ein automatisch generiertes Kennwort.

-serverURL 145.124.24.100
-unattended

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…