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

Verwenden Sie zum Erstellen von URIs für den Start von Omnissa 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 ADSI Edit auf dem Omnissa Horizon Connection Server-Host, navigieren Sie zum entsprechenden Horizon Connection Server und wählen Sie den OU=Applications-Knoten 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 Clienttypen generieren, wie z. B. Desktop-Clients und mobile Clients, finden Sie eine Liste der unterstützten Abfragen im Installations- und Einrichtungshandbuch für den jeweiligen Client-Systemtyp.

• action

  Werte, die mit der Abfrage „action“ verwendet werden können

  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. Wenn Sie die Aktion „browse“ verwenden und einen Remote-Desktop oder eine veröffentlichte Anwendung angeben, wird der Remote-Desktop oder die veröffentlichte Anwendung in der Liste der verfügbaren Elemente hervorgehoben.
  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.

• connectUSBOnInsert

  Verbindet ein USB-Gerät mit dem im Vordergrund angezeigten Remote-Desktop bzw. der veröffentlichten Anwendung, wenn Sie das Gerät anschließen. Diese Abfrage wird bedingungslos festgelegt, wenn Sie die Abfrage unattended für einen Remote-Desktop angeben. Zur Verwendung dieser Abfrage müssen Sie die Abfrage action auf start-session setzen oder ohne die Abfrage action arbeiten. Gültige Werte sind true und false. Ein Beispiel für die Syntax ist etwa connectUSBOnInsert=true.

• connectUSBOnStartup

  Leitet alle aktuell mit dem Clientsystem verbundenen USB-Geräte an den Remote-Desktop oder die veröffentlichte Anwendung um. Diese Abfrage wird bedingungslos festgelegt, wenn Sie die Abfrage unattended für einen Remote-Desktop angeben. Zur Verwendung dieser Abfrage müssen Sie die Abfrage action auf start-session setzen oder ohne die Abfrage action arbeiten. Gültige Werte sind true und false. Ein Beispiel für die Syntax ist etwa connectUSBOnStartup=true.

• desktopLayout

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

  Gültige Werte für die desktopLayout-Abfrage

  Wert	Beschreibung
  fullscreen	Vollbild auf einem Monitor.
  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.

• filePath

  Gibt den Pfad zur Datei im lokalen System an, die Sie mit der veröffentlichten Anwendung öffnen möchten. Sie können den vollständigen oder einen relativen Pfad angeben, z. B. ~/username/test%20file.txt. 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. Wenn Sie beispielsweise den Dateipfad /Users/username/test file.txt darstellen möchten, verwenden Sie /User/username/test%20file.txt.