Utilisation d'URI pour configurer Omnissa Horizon Client

Vous pouvez utiliser des identifiants uniformes de ressource (URI) pour créer une page Web ou des liens d'e-mail sur lesquels les utilisateurs finaux peuvent cliquer pour démarrer Horizon Client, se connecter à un serveur ou ouvrir un poste de travail distant ou une application publiée.

Vous pouvez créer ces liens en construisant des URI qui fournissent une partie ou l'intégralité des informations suivantes, afin que vos utilisateurs finaux n'aient pas à les fournir.

• Adresse du serveur
• Numéro de port du serveur
• Nom d'utilisateur Active Directory
• Nom de domaine
• Nom complet du poste de travail distant ou de l'application publiée
• Taille de la fenêtre
• Actions incluant la réinitialisation, la fermeture d'une session et le démarrage d'une session
• Protocole d'affichage

Pour construire un URI, vous pouvez utiliser le schéma d'URI horizon-client avec des éléments de chemin et de requête propres à Horizon Client.

Pour utiliser des URI pour démarrer Horizon Client, ce dernier doit déjà être installé sur les ordinateurs clients.

Syntaxe à utiliser pour créer des URI Horizon Client

La syntaxe d'URI comprend le schéma d'URI horizon-client, un chemin d'accès spécifiant le poste de travail distant ou l'application publiée et, en option, une requête permettant de spécifier les actions ou options de configuration relatives au poste de travail distant ou à l'application publiée.

Spécification d'URI

Lorsque vous créez un URI, vous appelez essentiellement horizon-client avec la chaîne path-and-query complète comme argument.

Utilisez la syntaxe suivante pour créer des URI afin de démarrer Horizon Client.

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

Le seul élément requis est le schéma d'URI, horizon-client. Étant donné que le nom du schéma est sensible à la casse pour des versions de certains systèmes d'exploitation clients, tapez horizon-client.

Important : pour tous les éléments, les caractères non-ASCII doivent d'abord être codés en UTF-8 [STD63], puis chaque octet de la séquence UTF-8 correspondante doit être codé en pourcentage pour être représenté en tant que caractères URI.

Pour plus d'informations sur le codage de caractères ASCII, reportez-vous à la référence de codage d'URL sur http://www.utf8-chartable.de/.

• authority-part

  L'adresse du serveur et, éventuellement, un nom d'utilisateur, un numéro de port non défini par défaut ou bien les deux. Les traits de soulignement (_) ne sont pas pris en charge dans les noms de serveur. Les noms de serveur doivent être conformes à la syntaxe DNS.

  Pour spécifier un nom d'utilisateur, utilisez la syntaxe suivante.

  user1@server-address
  

  Vous ne pouvez pas spécifier d'adresse UPN, ce qui inclut le nom domaine. Pour spécifier le domaine, vous pouvez utiliser la partie de requête domainName de l'URI.

  Pour spécifier un numéro de port, utilisez la syntaxe suivante.

  server-address:port-number
  

• path-part

  Le nom complet du poste de travail distant ou de l'application publiée. Le nom complet est spécifié dans Omnissa Horizon Console lorsque le pool de postes de travail ou d'applications est créé. Si le nom complet contient un espace, utilisez le mécanisme de codage %20 pour représenter l'espace.

  Vous pouvez également spécifier un ID de poste de travail ou d'application, qui est une chaîne de chemin d'accès comportant l'ID de pool de postes de travail ou d'application. Pour trouver un ID de poste de travail ou d'application, ouvrez ADSI Edit sur l'hôte Omnissa Horizon Connection Server, accédez à l'emplacement DC approprié et sélectionnez le nœud OU=Applications. Tous les pools de postes de travail et d'applications sont répertoriés. L'attribut distinguishedName spécifie la valeur de l'ID. Vous devez coder la valeur de l'ID avant de la spécifier dans un URI.

  Remarque : plusieurs applications publiées ou postes de travail distants peuvent avoir le même nom complet, mais l'ID de poste de travail et d'application est unique. Pour spécifier un poste de travail distant ou une application publiée spécifique, utilisez l'ID de poste de travail ou d'application plutôt que le nom complet.

• query-part

  Les options de configuration à utiliser, ou les actions du poste de travail distant ou de l'application publiée à effectuer. Les requêtes ne sont pas sensibles à la casse. Pour utiliser des requêtes multiples, utilisez une esperluette (&) entre les requêtes. Si les requêtes sont en conflit, Horizon Client utilise la dernière requête de la liste. Utilisez la syntaxe suivante.

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

Requêtes prises en charge

Les requêtes suivantes sont prises en charge pour ce type d'instance d'Horizon Client. Si vous créez des URI pour plusieurs types de clients, tels que des clients de postes de travail et des clients mobiles, reportez-vous au guide pour chaque type de système client pour connaître la liste des requêtes prises en charge.

• action
  Les valeurs suivantes peuvent être utilisées avec la requête d'action.

  Valeur	Description
  browse	Affiche une liste des postes de travail distants et des applications publiées disponibles hébergés sur le serveur spécifié. Vous n'êtes pas tenu de spécifier un poste de travail distant ou une application publiée lorsque vous effectuez cette action.
  start-session	Ouvre le poste de travail distant ou l'application publiée spécifique. Si aucune requête d'action n'est fournie et que le nom du poste de travail distant ou de l'application publiée est fourni, start-session est l'action par défaut.
  reset	Éteint, puis redémarre, le poste de travail distant ou l'application publiée spécifique. Les données non enregistrées sont perdues. La réinitialisation d'un poste de travail distant équivaut à appuyer sur le bouton Réinitialiser d'un ordinateur physique.
  restart	Éteint, puis redémarre le poste de travail distant spécifié. Le redémarrage d'un poste de travail distant revient à utiliser la commande de redémarrage du système d'exploitation Windows. Le système d'exploitation invite généralement l'utilisateur à enregistrer toutes les données non enregistrées avant de redémarrer.
  logoff	Déconnecte l'utilisateur du système d'exploitation invité sur le poste de travail distant. Si vous spécifiez une application publiée, l'action est ignorée ou l'utilisateur final voit le message d'avertissement « Action d'URI non valide ».

• args

  Spécifie les arguments de ligne de commande à ajouter au démarrage de l'application publiée. Utilisez la syntaxe args=valeur, où valeur est une chaîne. Utilisez le codage de pourcentage pour les caractères suivants :

  • Pour les deux-points (:), utilisez %3A
  • Pour une barre oblique inverse (\), utilisez %5C
  • Pour un espace ( ), utilisez %20
  • Pour un guillemet double ("), utilisez %22 Par exemple, pour spécifier le nom de fichier "My new file.txt" pour l'application Notepad++, utilisez %22My%20new%20file.txt%22.

• appProtocol

  Pour les applications publiées, les valeurs valides sont PCOIP et BLAST. Par exemple, pour spécifier le protocole PCoIP, utilisez la syntaxe appProtocol=PCOIP.

• desktopLayout

  Définit la taille de la fenêtre du poste de travail distant. Pour utiliser cette requête, vous devez définir la requête action sur start-session ou ne pas utiliser de requête action.

  Les valeurs suivantes peuvent être utilisées pour la requête desktopLayout.

  Valeur	Description
  fullscreen	Plein écran sur un moniteur. Il s'agit de la valeur par défaut.
  multimoniteur	Plein écran sur tous les moniteurs.
  windowLarge	Grande fenêtre.
  windowSmall	Petite fenêtre.
  WxH	Personnalisez la résolution, en spécifiant la largeur et la hauteur en pixels. Exemple de syntaxe : desktopLayout=1280x800.

• desktopProtocol

  Pour les postes de travail distants, les valeurs valides sont PCOIP et BLAST. Par exemple, pour spécifier le protocole PCoIP, utilisez la syntaxe desktopProtocol=PCOIP.

• domainName

  Spécifie le nom de domaine Network Basic Input/Output System associé à l'utilisateur qui se connecte au poste de travail distant ou à l'application publiée. Utilisez par exemple mycompany plutôt que mycompany.com.

• launchMinimized

  Démarre Horizon Client en mode réduit. La fenêtre Horizon Client reste réduite et masquée en arrière-plan lors du démarrage de l'application publiée ou du poste de travail distant spécifié par l'utilisateur. La syntaxe est launchMinimized=true. La valeur par défaut est false.

• useExisting

  La définition du paramètre -useExisting permet de contrôler si plusieurs instances d'Horizon Client peuvent s'exécuter simultanément. Lorsque vous définissez ce paramètre, Horizon Client conserve une seule instance en invitant à fermer toutes les sessions existantes avant de démarrer la nouvelle.

  Lorsque le paramètre -useExisting est défini, vous obtenez un indicateur permettant d'utiliser une seule instance du client. Un message s'affiche vous invitant à fermer la session de l'instance existante. Ensuite, une fois que vous avez accepté, la nouvelle s'ouvre.

  Lorsque le paramètre -useExisting n'est pas défini, une nouvelle instance du client s'ouvre.

  Exemple : <IP>?useExisting=true ou <IP>?useExisting=false Insérez l'adresse IP spécifiée à l'emplacement où celle-ci est affichée.

• unauthenticatedAccessEnabled

  • Si cette option est définie sur true, la fonctionnalité Accès non authentifié est activée. Le paramètre Fichier > Accès non authentifié est affiché dans l'interface utilisateur et est sélectionné.
  • Si cette option est définie sur false, la fonctionnalité Accès non authentifié est désactivée. Le paramètre Fichier > Accès non authentifié est affiché dans l'interface utilisateur et est désélectionné.
  • Si cette option est définie sur "", la fonctionnalité Accès non authentifié est désactivée et le paramètre Fichier > Accès non authentifié s'affiche dans l'interface utilisateur et est désélectionné. Exemple de syntaxe : unauthenticatedAccessEnabled=true.

• unauthenticatedAccessAccount

  Si la fonctionnalité Accès non authentifié est activée, le compte à utiliser est défini. Si la fonctionnalité Accès non authentifié est désactivée, cette requête est ignorée. Exemple de syntaxe utilisant le compte d'utilisateur anonymous1 : unauthenticatedAccessAccount=anonymous1.

Exemples d'URI Horizon Client

Vous pouvez utiliser le schéma d'URI horizon-client pour créer des liens hypertextes ou des boutons et inclure ces liens dans un e-mail ou sur une page Web. Par exemple, un utilisateur final peut cliquer sur un lien URl pour démarrer un poste de travail distant avec les options de démarrage que vous spécifiez.

Chaque exemple d'URI est suivi d'une description de ce que l'utilisateur final voit après avoir cliqué sur le lien URI.

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

   Horizon Client démarre et se connecte au serveur horizon.mycompany.com. La boîte de dialogue de connexion invite l'utilisateur à fournir un nom d'utilisateur, un nom de domaine et un mot de passe. Après l'ouverture de session, le client se connecte au poste de travail distant dont le nom complet est Primary Desktop, et l'utilisateur est connecté au système d'exploitation invité.

   Remarque : dans cet exemple, le protocole d'affichage et la taille de fenêtre par défaut sont utilisés. Le protocole d'affichage par défaut est PCoIP et la taille de fenêtre par défaut est le mode plein écran.

   Vous pouvez modifier les valeurs par défaut. Reportez-vous à la section Utilisation de l'interface de ligne de commande et des fichiers de configuration d'Horizon Client.

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

   Cet URI a le même effet que dans l'exemple précédent, sauf qu'il utilise le port non défini par défaut 7555 pour l'instance d'Horizon Connection Server. (Le port par défaut est 443.) Comme un identifiant de poste de travail distant est fourni, le poste de travail distant s'ouvre même si l'action start-session n'est pas incluse dans l'URI.

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

   Horizon Client démarre et se connecte au serveur horizon.mycompany.com. Dans la boîte de dialogue de connexion, la zone de texte Nom d'utilisateur contient le nom fred. L'utilisateur doit fournir le nom de domaine et le mot de passe. Après l'ouverture de session, le client se connecte au poste de travail distant dont le nom complet est Finance Desktop, et l'utilisateur est connecté au système d'exploitation invité. La connexion utilise le protocole d'affichage PCoIP.

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

   Horizon Client démarre et se connecte au serveur horizon.mycompany.com. Dans la boîte de dialogue de connexion, l'utilisateur doit fournir le nom d'utilisateur, le nom de domaine et le mot de passe. Après la connexion, le client se connecte à l'application publiée dont le nom complet est Calculator. La connexion utilise le protocole d'affichage d'Omnissa Horizon Blast.

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

   Horizon Client démarre et se connecte au serveur horizon.mycompany.com. Dans la boîte de dialogue de connexion, la zone de texte Nom d'utilisateur est remplie avec fred, et la zone de texte Domaine est remplie avec mycompany. L'utilisateur doit fournir uniquement un mot de passe. Après l'ouverture de session, le client se connecte au poste de travail distant dont le nom complet est Finance Desktop, et l'utilisateur est connecté au système d'exploitation invité.

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

   Horizon Client démarre et l'utilisateur est dirigé vers l'invite d'ouverture de session pour se connecter au serveur horizon.mycompany.com.

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

   Horizon Client démarre et se connecte au serveur horizon.mycompany.com. La boîte de dialogue de connexion invite l'utilisateur à fournir un nom d'utilisateur, un nom de domaine et un mot de passe. Une fois la connexion réussie, Horizon Client réinitialise le poste de travail spécifié.

   Remarque : cette action n'est disponible que si un administrateur a activé la fonctionnalité de réinitialisation pour le poste de travail distant.

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

   Horizon Client démarre et se connecte au serveur horizon.mycompany.com. La boîte de dialogue de connexion invite l'utilisateur à fournir un nom d'utilisateur, un nom de domaine et un mot de passe. Une fois la connexion réussie, Horizon Client redémarre le poste de travail spécifié.

   Remarque : cette action n'est disponible que si un administrateur a activé la fonctionnalité de redémarrage pour le poste de travail distant.

9. horizon-client://
   

   Horizon Client démarre et l'utilisateur est dirigé vers la page pour entrer l'adresse d'un serveur.

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

    Démarre My Notepad++ sur le serveur 10.10.10.10 et transmet l'argument My new file.txt dans la commande de démarrage de l'application publiée. Le nom de fichier est entre guillemets, car il contient des espaces.

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

    Démarre Notepad++ 12 sur le serveur 10.10.10.10 et transmet l'argument a.text b.txt dans la commande de démarrage de l'application publiée. Comme l'argument n'est pas entre guillemets, un espace sépare les noms de fichier et les deux fichiers sont ouverts séparément dans Notepad++.

    Remarque : les applications publiées peuvent utiliser les arguments de ligne de commande différemment. Par exemple, si vous transmettez l'argument a.txt b.txt à WordPad, WordPad n'ouvre qu'un seul fichier, a.txt.

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

    Horizon Client démarre et se connecte au serveur horizon.mycompany.com en utilisant le compte d'utilisateur anonymous1. L'application Notepad démarre sans inviter l'utilisateur à fournir ses informations d'identification.

Exemples de code HTML

Vous pouvez utiliser des URI pour créer des liens hypertextes et des boutons à inclure dans des e-mails ou sur des pages Web. Les exemples suivants montrent comment utiliser l'URI du premier exemple d'URI pour coder un lien hypertexte intitulé Test Link et un bouton intitulé TestButton.

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