Die URI-Syntax umfasst das URI-Schema vmware-view, 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 Generieren von URIs für den Start von Horizon Client die folgende Syntax.

vmware-view://[authority-part][/path-part][?query-part]

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

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

Informationen zur Codierung von ASCII-Zeichen finden Sie in der URL-Codierungsreferenz 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, auch keine Domäne. Zur Angabe des Domänennamens 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 Horizon Console angegeben, wenn der Desktop- oder der Anwendungspool erstellt wird. Wenn der Anzeigename ein Leerzeichen enthält, verwenden Sie den Codierungsmechanismus %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 aufzufinden, öffnen Sie den ADSI-Editor auf dem Verbindungsserver-Host, navigieren Sie zu DC=vdi,dc=vmware,dc=int und wählen Sie den Knoten OU=Applications aus. Alle Desktop- und Anwendungspools werden aufgelistet. Das Attribut distinguishedName legt den ID-Wert fest. Sie müssen den ID-Wert kodieren, bevor Sie ihn in einem URI angeben, z. B. cn%3Dwin7-32%2Cou%3Dapplications%2Cdc%3Dvdi%2Cdc%3Dvmware%2Cdc%3Dint.
Wenn Sie eine Desktop- oder Anwendungs-ID angeben, dürfen Sie nur Kleinbuchstaben verwenden, auch wenn die Desktop- oder Anwendungs-ID Großbuchstaben in ADSI Edit enthält.
Hinweis: Mehrere Remote-Desktops oder veröffentlichte Anwendungen können denselben Anzeigenamen besitzen. Desktop- und Anwendungs-ID sind jedoch eindeutig. Wenn Sie einen bestimmten Remotedesktop oder eine bestimmte veröffentlichte Anwendung angeben müssen, verwenden Sie anstelle des Anzeigenamens die Desktop-ID oder die Anwendungs-ID.
query-part
Die zu verwendenden Konfigurationsoptionen oder auszuführende Aktionen für den Remote-Desktop oder die veröffentlichte Anwendung. Für die Abfragen muss die Groß- und Kleinschreibung nicht beachtet werden. Verwenden Sie für den Einsatz mehrerer Abfragen das kaufmännische Und-Zeichen (&) zwischen den Abfragen. Wenn die Abfragen in Konflikt stehen, 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 Arten von Clients erstellen, wie z. B. Desktop-Clients und mobile Clients, finden Sie die Liste der unterstützten Abfragen im Installations- und Einrichtungshandbuch für jede Art von Clientsystem.

action
Tabelle 1. 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.
start-session Öffnet den angegebenen Remote-Desktop oder die angegebene 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 bzw. die angegebene veröffentlichte Anwendung herunter und startet ihn bzw. 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. Der Neustart eines Remote-Desktops entspricht dem Neustartbefehl für das Windows-Betriebssystem. In der Regel wird der Benutzer dabei vom Betriebssystem aufgefordert, alle nicht gespeicherten Daten zu speichern, bevor der Neustart erfolgt.
logoff Meldet den Benutzer vom Gastbetriebssystem auf dem Remote-Desktop ab. Wenn Sie eine veröffentlichte Anwendung angeben, wird die Aktion ignoriert, oder der Endbenutzer sieht die Warnmeldung „Ungültige URI-Aktion“.
args
Gibt Befehlszeilenargumente zum Hinzufügen an, wenn die veröffentlichte Anwendung gestartet wird. Verwenden Sie die Syntax args= Wert, wobei Wert eine Zeichenfolge sein muss. 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 beim Anschließen des Geräts mit dem im Vordergrund angezeigten Remote-Desktop bzw. der veröffentlichten Anwendung. 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 bzw. 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 Remote-Desktop-Fensters fest. Zur Verwendung dieser Abfrage müssen Sie die Abfrage action auf start-session setzen oder die Abfrage action nicht verwenden.
Tabelle 2. Gültige Werte für desktopLayout-Abfrage
Wert Beschreibung
fullscreen Vollbild auf einem Monitor. Dieser Wert ist der Standardwert.
multimonitor Vollbild auf allen Monitoren.
windowLarge Großes Fenster.
windowSmall Kleines Fenster.
WxH Benutzerdefinierte Auflösung, bei der Sie die Breite mal Höhe in Pixel angeben. Ein Beispiel für die Syntax ist etwa desktopLayout=1280x800.
desktopProtocol
Gültige Werte für Remote-Desktops sind RDP, PCOIP und BLAST. Zur Angabe von PCoIP verwenden Sie beispielsweise die Syntax desktopProtocol=PCOIP.
domainName
Gibt den NETBIOS-Domänennamen an, der mit dem Benutzer verknüpft ist, der eine Verbindung zum Remote-Desktop bzw. zur veröffentlichten Anwendung herstellt. Beispielsweise ist es sinnvoller, MeineFirma als MeineFirma.com zu verwenden.
filePath
Gibt den Pfad zur Datei im lokalen System an, die Sie mit einer veröffentlichten Anwendung öffnen möchten. Sie müssen den vollständigen Pfad einschließlich des Laufwerksbuchstabens eingeben. 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.

Um beispielsweise den Dateipfad C:\test file.txt darzustellen, verwenden Sie C%3A%5Ctest%20file.txt.

launchMinimized
Startet Horizon Client im minimierten Modus. Horizon Client bleibt minimiert, bis der angegebene Remote-Desktop oder die angegebene veröffentlichte Anwendung gestartet wird. Die Syntax lautet launchMinimized=true. Sie können diese Abfrage nicht mit der unbeaufsichtigten Abfrage verwenden.
tokenUserName
Gibt den RSA- oder RADIUS-Benutzernamen an. Verwenden Sie diese Abfrage nur, wenn der RSA- oder RADIUS-Benutzername nicht mit dem Active Directory-Benutzernamen identisch ist. Wenn Sie diese Abfrage nicht angeben und die RSA- oder RADIUS-Authentifizierung erforderlich ist, verwendet Horizon Client den Windows-Benutzernamen. Die Syntax lautet tokenUserName=name.
unattended
Erstellt eine Serververbindung zu einem Remote-Desktop im Kioskmodus. Wenn Sie diese Abfrage verwenden, geben Sie keine Benutzerinformationen an, wenn Sie den Kontonamen aus der MAC-Adresse des Clientgeräts generiert haben. Wenn Sie benutzerdefinierte Kontonamen in ADAM generiert haben, z. B. Namen, die mit „custom-“ beginnen, müssen Sie die Kontoinformationen angeben.
useExisting
Wenn für diese Option True festgelegt ist, kann nur eine Horizon Client-Instanz ausgeführt werden. Wenn Benutzer eine Verbindung zu einem zweiten Server herstellen möchten, müssen sie sich vom ersten Server abmelden, damit die Sitzungen mit Remote-Desktops und veröffentlichten Anwendungen getrennt werden. Ist für diese Option False festgelegt, können mehrere Horizon Client-Instanzen ausgeführt werden und die Benutzer haben die Möglichkeit, mit mehreren Servern gleichzeitig eine Verbindung herzustellen. Die Standardeinstellung ist True. Ein Beispiel für die Syntax ist etwa useExisting=false.
unauthenticatedAccessEnabled
Wenn für diese Option True festgelegt ist, ist die Funktion für den nicht authentifizierten Zugriff standardmäßig aktiviert. Die Option Anonym mit nicht authentifiziertem Zugriff anmelden ist dann in der Benutzeroberfläche verfügbar und aktiviert. Wenn für diese Option False festgelegt ist, ist die Funktion für den nicht authentifizierten Zugriff deaktiviert. Die Einstellung Anonym mit nicht authentifiziertem Zugriff anmelden ist dann ausgeblendet und deaktiviert. Wenn für diese Option "" festgelegt ist, ist die Funktion für den nicht authentifizierten Zugriff deaktiviert. Die Einstellung Anonym mit nicht authentifiziertem Zugriff anmelden ist dann nicht mehr in der Benutzeroberfläche verfügbar und deaktiviert. Ein Beispiel für die Syntax ist etwa unauthenticatedAccessEnabled=true.
unauthenticatedAccessAccount
Wenn die Funktion für nicht authentifizierten Zugriff aktiviert ist, legt dies das zu verwendende Konto fest. Wenn der nicht authentifizierte Zugriff deaktiviert ist, wird diese Abfrage ignoriert. Die entsprechende Syntax lautet beispielsweise bei Verwendung des Benutzerkontos anonymous1 dann unauthenticatedAccessAccount=anonymous1.