Verwenden von URIs zur Konfiguration von Horizon Client

Sie können Uniform Resource Identifiers (URIs) verwenden, um Webseiten- oder E-Mail-Links zu 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

Verwenden Sie zur Generierung eines URI das URI-Schema vmware-view mit Horizon Client-spezifischen Pfad- und Abfragekomponenten.

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

Syntax für die Erstellung von vmware-view-URIs

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

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

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.

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 Clienttypen generieren, wie z. B. Desktop-Clients und mobile Clients, finden Sie die Liste der unterstützten Abfragen im Handbuch für alle Clientsystemtypen.

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.

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.
`W`x`H`	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.

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 veröffentlichte Anwendung gestartet wird. Die Syntax lautet launchMinimized=true. Der Standardwert lautet false.

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 aktiviert. Die Einstellung Datei > Nicht authentifizierter Zugriff ist auf der Benutzeroberfläche sichtbar und ausgewählt.
Wenn für diese Option False festgelegt ist, ist die Funktion für den nicht authentifizierten Zugriff deaktiviert. Die Einstellung Datei > Nicht authentifizierter Zugriff ist auf der Benutzeroberfläche sichtbar und deaktiviert.
Wenn diese Option auf "" gesetzt ist, wird die Funktion „Nicht authentifizierter Zugriff“ deaktiviert und die Einstellung Datei > Nicht authentifizierter Zugriff ist auf der Benutzeroberfläche sichtbar 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.

Beispiele für vmware-view-URIs

Sie können das URI-Schema vmware-view verwenden, um Hypertext-Links oder Schaltflächen zu erstellen und diese Links in E-Mails oder Webseiten aufzunehmen. Beispielsweise kann ein Endbenutzer auf einen URI-Link klicken, um einen Remote-Desktop mit den angegebenen Startoptionen zu starten.

Nach jedem URI-Beispiel finden Sie eine Beschreibung, was der Endbenutzer nach Anklicken des URI-Links sieht.

```
vmware-view://view.mycompany.com/Primary%20Desktop?action=start-session
```
Horizon Client startet und stellt eine Verbindung zum view.mycompany.com-Server her. Das Anmeldedialogfeld fordert den Benutzer zur Eingabe von Benutzernamen, Domänennamen und Kennwort auf. Nach einer erfolgreichen Anmeldung stellt der Client eine Verbindung zum Remote-Desktop her, dessen Anzeigename Primary Desktop lautet. Der Benutzer wird dann beim Gastbetriebssystem angemeldet.

Hinweis: In diesem Beispiel werden das Standardanzeigeprotokoll und die Standardfenstergröße verwendet. Das Standardanzeigeprotokoll ist PCoIP, und die Standardfenstergröße ist Vollbild.
Diese Standardwerte können geändert werden. Siehe Verwenden der vmware-view-Befehlszeilenschnittstelle und -Konfigurationsdateien.
```
vmware-view://view.mycompany.com/cn%3Dwin7-32%2Cou%3Dapplications%2Cdc%3Dvdi%2Cdc%3Dvmware%2Cdc%3Dint
```
Horizon Client startet und stellt eine Verbindung zum view.mycompany.com-Server her. Das Anmeldedialogfeld fordert den Benutzer zur Eingabe von Benutzernamen, Domänennamen und Kennwort auf. Nach einer erfolgreichen Anmeldung stellt der Client eine Verbindung mit dem Remote-Desktop her, der die Desktop-ID CN=win7-32,OU=Applications,DC=vdi,DC=vmware,DC=int (kodierter Wert cn%3Dwin7-32%2Cou%3Dapplications%2Cdc%3Dvdi%2Cdc%3Dvmware%2Cdc%3Dint) besitzt.
```
vmware-view://view.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 Verbindungsserverinstanz verwendet. (Der standardmäßige Port lautet 443.) Da ein Remote-Desktop-Bezeichner bereitgestellt wird, wird der Remote-Desktop geöffnet, obwohl die Aktion start-session nicht im URI enthalten ist.
```
vmware-view://[email protected]/Finance%20Desktop?desktopProtocol=PCOIP
```
Horizon Client startet und stellt eine Verbindung zum view.mycompany.com-Server her. Im Anmeldedialogfeld wird das Textfeld Benutzername mit dem Namen fred gefüllt. Der Benutzer muss den Domänennamen und das Kennwort eingeben. Nach einer erfolgreichen Anmeldung stellt der Client eine Verbindung zum Remote-Desktop her, dessen Anzeigename Finance Desktop lautet. Der Benutzer wird dann beim Gastbetriebssystem angemeldet. Die Verbindung nutzt das PCoIP-Anzeigeprotokoll.
```
vmware-view://view.mycompany.com/Calculator?action=start-session&appProtocol=BLAST
```
Horizon Client startet und stellt eine Verbindung zum view.mycompany.com-Server her. In das Anmeldedialogfeld muss der Benutzer 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 VMware Blast-Anzeigeprotokoll.
```
vmware-view://[email protected]/Finance%20Desktop?domainName=mycompany
```
Horizon Client startet und stellt eine Verbindung zum view.mycompany.com-Server her. Im Anmeldedialogfeld wird das Textfeld Benutzername mit dem Namen fred und das Textfeld Domäne mit mycompany gefüllt. Der Benutzer muss das Kennwort eingeben. Nach einer erfolgreichen Anmeldung stellt der Client eine Verbindung zum Remote-Desktop her, dessen Anzeigename Finance Desktop lautet. Der Benutzer wird dann beim Gastbetriebssystem angemeldet.
```
vmware-view://view.mycompany.com/
```
Horizon Client startet und der Benutzer wird zur Anmeldeaufforderung für die Verbindung mit dem Server view.mycompany.com geleitet.
```
vmware-view://view.mycompany.com/Primary%20Desktop?action=reset
```
Horizon Client startet und stellt eine Verbindung zum view.mycompany.com-Server her. Das Anmeldedialogfeld fordert den Benutzer zur Eingabe von Benutzernamen, Domänennamen und Kennwort 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.
```
vmware-view://view.mycompany.com/Primary%20Desktop?action=restart
```
Horizon Client startet und stellt eine Verbindung zum view.mycompany.com-Server her. Das Anmeldedialogfeld fordert den Benutzer zur Eingabe von Benutzernamen, Domänennamen und Kennwort auf. Nach einer erfolgreichen Anmeldung startet Horizon Client den angegebenen Desktop neu.

Hinweis: Diese Aktion ist nur verfügbar, wenn ein Administrator die Neustartfunktion für den Remote-Desktop aktiviert hat.
```
vmware-view://
```
Horizon Client startet und der Benutzer wird zu der Seite geleitet, auf der die Adresse eines Servers eingegeben werden kann.
```
vmware-view://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 an den Befehl zum Start der veröffentlichten Anwendung. Der Dateiname ist in doppelte Anführungszeichen gesetzt, da er Leerzeichen enthält.
```
vmware-view://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 an den Befehl zum Start der veröffentlichten Anwendung. Da dieses Argument nicht in Anführungszeichen gesetzt ist, trennt ein Leerzeichen die Dateinamen und die beiden Dateien werden gesondert in Notepad++ geöffnet.

Hinweis: Veröffentlichte Anwendungen können sich in der Umsetzung von Befehlszeilenargumenten unterscheiden. Wenn Sie beispielsweise das Argument a.txt b.txt an WordPad übergeben, öffnet WordPad nur eine Datei, a.txt.
```
vmware-view://view.mycompany.com/Notepad?unauthenticatedAccessEnabled=true&unauthenticatedAccessAccount=anonymous1
```
Horizon Client startet und stellt mithilfe des Benutzerkontos anonymous1 eine Verbindung mit dem view.mycompany.com-Server her. Die Anwendung „Editor“ wird ohne Aufforderung des Benutzers zur Eingabe seiner Anmeldedaten gestartet.

Beispiel für HTML-Code

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 codieren.

<html>
<body>

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

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

</body>
</html>