Verwenden von URIs zur Konfiguration von Omnissa Horizon Client

Mithilfe von Uniform Resource Identifiers (URIs) können Sie Webseiten- oder E-Mail-Links erstellen, auf die Endbenutzer klicken können, um Horizon Client zu starten, eine Verbindung zu einem Server herzustellen oder einen Remote-Desktop bzw. eine veröffentlichte Anwendung zu öffnen.

Diese Links werden durch die Generierung von URIs erstellt, die einige oder alle der folgenden Informationen bereitstellen, sodass die Endbenutzer diese nicht angeben müssen.

• Serveradresse
• Portnummer für den Server
• Active Directory-Benutzername
• Domänenname
• Anzeigename des Remote-Desktops oder der veröffentlichten Anwendung
• Fenstergröße
• Aktionen, darunter „Zurücksetzen“, „Abmelden“ und „Sitzung starten“
• Anzeigeprotokoll

Um einen URI zu erstellen, verwenden Sie das URI-Schema horizon-client mit Horizon Client-spezifischen Pfad- und Abfragekomponenten.

Um URIs zum Starten von Horizon Client zu verwenden, muss Horizon Client bereits auf den Clientcomputern installiert sein.

Syntax für die Erstellung von Horizon Client-URIs

Die URI-Syntax umfasst das URI-Schema horizon-client, einen Pfadauszug zur Angabe des Remote-Desktops oder der veröffentlichten Anwendung sowie optional eine Abfrage zur Angabe von Aktionen oder Konfigurationsoptionen für den Remote-Desktop oder die veröffentlichte Anwendung.

URI-Spezifikation

Beim Erstellen eines URI rufen Sie im Grunde genommen horizon-client mit der vollständigen Pfad-und-Abfrage-Zeichenfolge als Argument auf.

Verwenden Sie zum Erstellen von URIs für den Start von Horizon Client die folgende Syntax.

horizon-client://[authority-part][/path-part][?query-part]

Das einzig erforderliche Element ist das URI-Schema horizon-client. Da der Schemaname für einige Versionen bestimmter Clientbetriebssysteme die Groß-/Kleinschreibung beachtet, geben Sie horizon-client ein.

Wichtig: In allen Abschnitten müssen Nicht-ASCII-Zeichen zunächst gemäß UTF-8 [STD63] kodiert werden. Anschließend muss für jedes Oktett der entsprechenden UTF-8-Sequenz eine Prozentkodierung durchgeführt werden, um diese als URI-Zeichen darzustellen.

Informationen zur Kodierung von ASCII-Zeichen finden Sie in der URL-Kodierungsreferenz unter http://www.utf8-chartable.de/.

• authority-part

  Die Serveradresse und optional ein Benutzername, eine nicht standardmäßige Portnummer oder beides. Unterstriche (_) werden in Servernamen nicht unterstützt. Die Servernamen müssen der DNS-Syntax entsprechen.

  Verwenden Sie zur Angabe eines Benutzernamens die folgende Syntax.

  user1@server-address
  

  Sie können keine UPN-Adresse angeben, die die Domäne enthält. Zur Angabe der Domäne können Sie den Abfrageteil „domainName“ im URI verwenden.

  Verwenden Sie zur Angabe einer Portnummer die folgende Syntax.

  server-address:port-number
  

• path-part

  Der Anzeigename des Remote-Desktops oder der veröffentlichten Anwendung. Der Anzeigename wird in Omnissa Horizon Console angegeben, wenn der Desktop- oder der Anwendungspool erstellt wird. Wenn der Anzeigename ein Leerzeichen enthält, verwenden Sie den Kodierungsmechanismus %20, um das Leerzeichen darzustellen.

  Alternativ können Sie eine Desktop-ID oder eine Anwendungs-ID angeben, bei der es sich um eine Pfadangabe einschließlich der Desktop-ID oder der Anwendungspool-ID handelt. Um eine Desktop- oder Anwendungs-ID zu finden, öffnen Sie den ADSI-Editor auf dem Omnissa Horizon Connection Server-Host, navigieren Sie zum DC-Speicherort und wählen Sie den Knoten OU=Applications aus. Alle Desktop- und Anwendungspools werden aufgelistet. Das Attribut distinguishedName gibt den ID-Wert an. Sie müssen den ID-Wert kodieren, bevor Sie ihn in einem URI angeben.

  Hinweis: Mehrere Remote-Desktops oder veröffentlichte Anwendungen können denselben Anzeigenamen besitzen. Desktop- und Anwendungs-ID sind jedoch eindeutig. Um einen bestimmten Remote-Desktop oder eine veröffentlichte Anwendung anzugeben, verwenden Sie die Desktop- oder Anwendungs-ID und nicht den Anzeigenamen.

• query-part

  Zu verwendende Konfigurationsoptionen oder auszuführende Aktionen für den Remote-Desktop oder die veröffentlichte Anwendung. Bei Abfragen wird die Groß- und Kleinschreibung nicht beachtet. Verwenden Sie für den Einsatz mehrerer Abfragen das kaufmännische Und-Zeichen (&) zwischen den Abfragen. Bei kollidierenden Abfragen verwendet Horizon Client die letzte Abfrage in der Liste. Verwenden Sie die folgende Syntax.

  query1=value1[&query2=value2...]
  

Unterstützte Abfragen

Die folgenden Abfragen werden für diesen Horizon Client-Typ unterstützt. Wenn Sie URIs für mehrere Client-Typen erstellen, wie z. B. für Desktop-Clients und mobile Clients, finden Sie die Liste der unterstützten Abfragen im Leitfaden für den jeweiligen Client-Typ.

• action
  Die folgenden Werte können mit der Abfrage „action“ verwendet werden.

  Wert	Beschreibung
  browse	Zeigt eine Liste der verfügbaren Remote-Desktops und veröffentlichten Anwendungen an, die auf dem angegebenen Server gehostet werden. Bei Verwendung dieser Aktion müssen Sie keinen Remote-Desktop bzw. keine veröffentlichte Anwendung angeben.
  start-session	Öffnet den angegebenen Remote-Desktop oder die veröffentlichte Anwendung. Wenn keine „action“-Abfrage bereitgestellt wird und der Name des Remote-Desktops oder der veröffentlichten Anwendung angegeben wird, ist „start-session“ die Standardaktion.
  reset	Fährt den angegebenen Remote-Desktop oder die veröffentlichte Anwendung herunter und startet sie neu. Nicht gespeicherte Daten gehen verloren. Das Zurücksetzen eines Remote-Desktops entspricht dem Betätigen der Reset-Taste auf einem physischen PC.
  restart	Fährt den angegebenen Remote-Desktop herunter und startet ihn neu. Das Neustarten eines Remote-Desktops entspricht dem Befehl zum Neustarten des Windows-Betriebssystems. Das Betriebssystem fordert den Benutzer in der Regel auf, nicht gespeicherte Daten vor dem Neustart zu speichern.
  logoff	Meldet den Benutzer vom Gastbetriebssystem auf dem Remote-Desktop ab. Wenn Sie eine veröffentlichte Anwendung angeben, wird die Aktion ignoriert oder dem Endbenutzer wird die Warnmeldung „Ungültige URI-Aktion“ angezeigt.

• args

  Gibt hinzuzufügende Befehlszeilenargumente an, wenn die veröffentlichte Anwendung gestartet wird. Verwenden Sie die Syntax args=Wert, wobei Wert eine Zeichenfolge ist. Verwenden Sie für die folgenden Zeichen die Prozentkodierung:

  • Für einen Doppelpunkt (:) verwenden Sie %3A.
  • Für einen umgekehrten Schrägstrich (\) verwenden Sie %5C.
  • Für ein Leerzeichen ( ) verwenden Sie %20.
  • Für ein doppeltes Anführungszeichen (") verwenden Sie %22. Um beispielsweise den Dateinamen "My new file.txt" für die Notepad++-Anwendung anzugeben, verwenden Sie %22My%20new%20file.txt%22.

• appProtocol

  Gültige Werte für veröffentlichte Anwendungen sind PCOIP und BLAST. Zur Angabe von PCoIP verwenden Sie beispielsweise die Syntax appProtocol=PCOIP.

• desktopLayout

  Legt die Größe des Remote-Desktop-Fensters fest. Zur Verwendung dieser Abfrage müssen Sie die Abfrage action auf start-session setzen oder ohne die Abfrage action arbeiten.

  Die folgenden Werte können für die Abfrage „desktopLayout“ verwendet werden.

  Wert	Beschreibung
  fullscreen	Vollbild auf einem Monitor. Dies ist der Standardwert.
  multimonitor	Vollbild auf allen Monitoren.
  windowLarge	Großes Fenster.
  windowSmall	Kleines Fenster.
  WxH	Benutzerdefinierte Auflösung, bei der Sie Breite mal Höhe in Pixeln angeben. Ein Beispiel für die Syntax ist etwa desktopLayout=1280x800.

• desktopProtocol

  Gültige Werte für Remote-Desktops sind PCOIP und BLAST. Zur Angabe von PCoIP verwenden Sie beispielsweise die Syntax desktopProtocol=PCOIP.

• domainName

  Gibt den NETBIOS-Domänennamen an, der dem Benutzer zugeordnet ist, der eine Verbindung mit dem Remote-Desktop oder der veröffentlichten Anwendung herstellt. Beispielsweise ist es sinnvoller, mycompany als mycompany.com zu verwenden.

• launchMinimized

  Startet Horizon Client im minimierten Modus. Das Horizon Client-Fenster bleibt minimiert und wird im Hintergrund ausgeblendet, während der vom Benutzer angegebene Remote-Desktop oder die vom Benutzer angegebene veröffentlichte Anwendung gestartet wird. Die Syntax lautet launchMinimized=true. Der Standardwert lautet false.

• useExisting

  Durch Festlegen des Parameters -useExisting können Sie angeben, ob mehrere Horizon Client-Instanzen gleichzeitig ausgeführt werden können. Wenn Sie diesen Parameter festlegen, behält Horizon Client eine einzelne Instanz. Sie werden aufgefordert, alle vorhandenen Sitzungen zu schließen, bevor Sie eine neue Sitzung starten.

  Nach dem Festlegen des Parameters -useExisting werden Sie darauf hingewiesen, eine einzelne Instanz des Clients zu verwenden. Eine Nachricht zum Abmelden bei der vorhandenen Instanz wird angezeigt. Sobald dies bestätigt wurde, wird die neue Instanz geöffnet.

  Wenn der Parameter -useExisting nicht festgelegt wird, wird eine neue Instanz des Clients geöffnet.

  Beispiel: <IP>?useExisting=true oder <IP>?useExisting=false Fügen Sie Ihre angegebene IP-Adresse an der Stelle ein, an der „IP“ angezeigt wird.

• unauthenticatedAccessEnabled

  • Wenn diese Option auf true festgelegt wird, ist die Funktion „Nicht authentifizierter Zugriff“ aktiviert. Die Einstellung Datei > Nicht authentifizierter Zugriff wird auf der Benutzeroberfläche angezeigt und ist aktiviert.
  • Wenn für diese Option false festgelegt ist, ist die Funktion für den nicht authentifizierten Zugriff deaktiviert. Die Einstellung Datei > Nicht authentifizierter Zugriff wird auf der Benutzeroberfläche angezeigt und ist deaktiviert.
  • Wenn diese Option auf "" festgelegt ist, wird die Funktion „Nicht authentifizierter Zugriff“ deaktiviert und die Einstellung Datei > Nicht authentifizierter Zugriff wird auf der Benutzeroberfläche angezeigt und ist deaktiviert. Ein Beispiel für die Syntax ist etwa unauthenticatedAccessEnabled=true.

• unauthenticatedAccessAccount

  Wenn die Funktion „Nicht authentifizierten Zugriff“ aktiviert ist, legt dies das zu verwendende Konto fest. Wenn die Funktion „Nicht authentifizierten Zugriff“ deaktiviert ist, wird diese Abfrage ignoriert. Ein Beispiel für die Syntax bei Verwendung des Benutzerkontos anonymous1 ist unauthenticatedAccessAccount=anonymous1.

Beispiele für Horizon Client-URIs

Sie können das URI-Schema horizon-client verwenden, um Hypertext-Links oder Schaltflächen zu erstellen und diese Links in E-Mails oder Webseiten aufzunehmen. Ein Endbenutzer kann auf einen URI-Link klicken, um beispielsweise einen Remote-Desktop mit den von Ihnen angegebenen Startoptionen zu öffnen.

Nach jedem URI-Beispiel finden Sie eine Beschreibung dessen, was dem Endbenutzer nach dem Klicken auf den URI-Link angezeigt wird.

1. horizon-client://horizon.mycompany.com/Primary%20Desktop?action=start-session
   

   Horizon Client wird gestartet und stellt eine Verbindung zum horizon.mycompany.com Server her. Das Dialogfeld „Anmeldung“ fordert den Benutzer zur Eingabe eines Benutzernamens, Domänennamens und Kennworts auf. Nach erfolgreicher Anmeldung stellt der Client eine Verbindung zum Remote-Desktop mit dem Anzeigenamen Primary Desktop her. Der Benutzer wird dann beim Gastbetriebssystem angemeldet.

   Hinweise: In diesem Beispiel werden das Standardanzeigeprotokoll und die Standardfenstergröße verwendet. Das Standardanzeigeprotokoll ist PCoIP und die Standardfenstergröße ist Vollbild.

   Die Standardeinstellungen können geändert werden. Weitere Informationen finden Sie unter Verwenden der horizon-client-Befehlszeilenschnittstelle und -Konfigurationsdateien.

2. horizon-client://horizon.mycompany.com:7555/Primary%20Desktop
   

   Dieser URI hat die gleiche Wirkung wie im vorherigen Beispiel, außer dass er den nicht standardmäßigen Port 7555 für die Horizon Connection Server-Instanz verwendet. (Der Standardport lautet 443.) Wegen der Bereitstellung eines Remote-Desktop-Bezeichners wird der Remote-Desktop geöffnet, obwohl die Aktion start-session nicht im URI enthalten ist.

3. horizon-client://fred@horizon.mycompany.com/Finance%20Desktop?desktopProtocol=PCOIP
   

   Horizon Client wird gestartet und stellt eine Verbindung zum horizon.mycompany.com Server her. Im Anmeldedialogfeld wird das Textfeld Benutzername mit fred gefüllt. Der Benutzer muss den Domänennamen und das Kennwort eingeben. Nach erfolgreicher Anmeldung stellt der Client eine Verbindung zum Remote-Desktop mit dem Anzeigenamen Finance Desktop her. Der Benutzer wird dann beim Gastbetriebssystem angemeldet. Die Verbindung nutzt das PCoIP-Anzeigeprotokoll.

4. horizon-client://horizon.mycompany.com/Calculator?action=start-session&appProtocol=BLAST
   

   Horizon Client wird gestartet und stellt eine Verbindung zum horizon.mycompany.com Server her. Der Benutzer muss im Dialogfeld „Anmeldung“ den Benutzernamen, den Domänennamen und das Kennwort eingeben. Nach einer erfolgreichen Anmeldung verbindet sich der Client mit der veröffentlichten Anwendung mit dem Anzeigenamen Calculator. Die Verbindung nutzt das Omnissa Horizon Blast-Anzeigeprotokoll.

5. horizon-client://fred@horizon.mycompany.com/Finance%20Desktop?domainName=mycompany
   

   Horizon Client wird gestartet und stellt eine Verbindung zum horizon.mycompany.com Server her. Im Anmeldedialogfeld wird das Textfeld Benutzername mit fred und das Textfeld Domäne mit mycompany gefüllt. Der Benutzer muss das Kennwort eingeben. Nach erfolgreicher Anmeldung stellt der Client eine Verbindung zum Remote-Desktop mit dem Anzeigenamen Finance Desktop her. Der Benutzer wird dann beim Gastbetriebssystem angemeldet.

6. horizon-client://horizon.mycompany.com/
   

   Horizon Client wird gestartet, und der Benutzer wird zur Anmeldeaufforderung für die Verbindung mit dem horizon.mycompany.com Server geleitet.

7. horizon-client://horizon.mycompany.com/Primary%20Desktop?action=reset
   

   Horizon Client wird gestartet und stellt eine Verbindung zum horizon.mycompany.com Server her. Das Dialogfeld „Anmeldung“ fordert den Benutzer zur Eingabe eines Benutzernamens, Domänennamens und Kennworts auf. Nach einer erfolgreichen Anmeldung setzt Horizon Client den angegebenen Desktop zurück.

   Hinweis: Diese Aktion ist nur verfügbar, wenn ein Administrator die Funktion zum Zurücksetzen für den Remote-Desktop aktiviert hat.

8. horizon-client://horizon.mycompany.com/Primary%20Desktop?action=restart
   

   Horizon Client wird gestartet und stellt eine Verbindung zum horizon.mycompany.com Server her. Das Dialogfeld „Anmeldung“ fordert den Benutzer zur Eingabe eines Benutzernamens, Domänennamens und Kennworts auf. Nach einer erfolgreichen Anmeldung startet Horizon Client den angegebenen Desktop neu.

   Hinweis: Diese Aktion ist nur verfügbar, wenn ein Administrator die Funktion zum Neustarten für den Remote-Desktop aktiviert hat.

9. horizon-client://
   

   Horizon Client wird gestartet, und der Benutzer wird zu der Seite geleitet, auf der die Adresse eines Servers eingegeben werden kann.

10. horizon-client://10.10.10.10/My%20Notepad++?args=%22My%20new%20file.txt%22
    

    Startet My Notepad++ auf dem Server 10.10.10.10 und übergibt das Argument My new file.txt im Startbefehl der veröffentlichten Anwendung. Der Dateiname ist in doppelte Anführungszeichen gesetzt, da er Leerzeichen enthält.

11. horizon-client://10.10.10.10/Notepad++%2012?args=a.txt%20b.txt
    

    Startet Notepad++ 12 auf dem Server 10.10.10.10 und übergibt das Argument a.text b.txt im Startbefehl der veröffentlichten Anwendung. Da das Argument nicht in Anführungszeichen gesetzt ist, trennt ein Leerzeichen die Dateinamen und die beiden Dateien werden separat in Notepad++ geöffnet.

    Hinweis: Veröffentlichte Anwendungen können sich in der Verwendung von Befehlszeilenargumenten unterscheiden. Wenn Sie beispielsweise das Argument a.txt b.txt an WordPad übergeben, öffnet WordPad nur eine Datei, a.txt.

12. horizon-client://horizon.mycompany.com/Notepad?unauthenticatedAccessEnabled=true&unauthenticatedAccessAccount=anonymous1
    

    Horizon Client wird gestartet und stellt über das Benutzerkonto anonymous1 eine Verbindung zum Server horizon.mycompany.com her. Die Editor-Anwendung wird ohne Aufforderung des Benutzers zur Eingabe seiner Anmeldedaten gestartet.

HTML-Codebeispiele

Sie können URIs verwenden, um Hypertext-Links und Schaltflächen zu erstellen, die in E-Mails oder auf Webseiten eingebunden werden können. Die folgenden Beispiele veranschaulichen, wie Sie den URI aus dem ersten Beispiel verwenden, um einen Hypertext-Link mit dem Text Test Link und eine Schaltfläche mit dem Text TestButton zu kodieren.

<html>
<body>

<a href="horizon-client://horizon.mycompany.com/Primary%20Desktop?action=start-session">Test Link</a><br>

<form><input type="button" value="TestButton" onClick="window.location.href=
'horizon-client://horizon.mycompany.com/Primary%20Desktop?action=start-session'"></form> <br>

</body>
</html>