La syntaxe inclut une partie de chemin d'accès visant à spécifier le serveur et, en option, une requête pour spécifier un utilisateur, un poste de travail ou une application et des actions ou options de configuration.

Spécification d'URI

Utilisez la syntaxe suivante pour créer des URI permettant de démarrer les clients Web HTML Access :

https://authority-part[/?query-part]
authority-part
Spécifie l'adresse du serveur et, en option, un numéro de port non défini par défaut. Les noms de serveur doivent être conformes à la syntaxe DNS.

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

server-address:port-number
query-part
Spécifie les options de configuration à utiliser ou les actions à effectuer. Les requêtes ne sont pas sensibles à la casse. Pour utiliser plusieurs requêtes, utilisez une esperluette (&) entre les requêtes. En cas de conflit entre des requêtes, la dernière requête de la liste est utilisée. Utilisez la syntaxe suivante :
query1=value1[&query2=value2...]

Respectez les instructions suivantes lors de la création d'une partie de requête :

  • Si vous n'utilisez pas au moins l'une des requêtes prises en charge, la page par défaut du portail Web de VMware Horizon s'affiche.
  • Dans la partie de requête, certains caractères spéciaux ne sont pas pris en charge, et vous devez les entrer au format de codage d'URL suivant : pour le symbole dièse (#) utilisez %23, pour le signe de pourcentage (%) utilisez %25, pour l'esperluette (&) utilisez %26, pour l'arobase (@) utilisez %40 et pour la barre oblique inverse (\) utilisez %5C.

    Pour en savoir plus sur le codage d'URL, consultez http://www.w3schools.com/tags/ref_urlencode.asp.

  • Dans la partie de requête, les caractères non ASCII doivent d'abord être encodé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 l'encodage de caractères ASCII, consultez la référence d'encodage d'URL sur http://www.utf8-chartable.de/.

Requêtes prises en charge

Cette rubrique répertorie les requêtes prises en charge pour le client Web HTML Access Web client. Si vous créez des URI pour plusieurs types de clients, tels que des clients de postes de travail et des clients mobiles, consultez le document Utilisation de VMware Horizon Client pour chaque type de système client.

action
Tableau 1. Valeurs pouvant être utilisées avec la requête d'action
Valeur Description
browse Affiche une liste des postes de travail et applications disponibles hébergés sur le serveur spécifié. Il ne vous est pas demandé de spécifier un poste de travail ou une application pour l'utilisation de cette action.
start-session Démarre l'application ou le poste de travail spécifié. Si aucune requête d'action n'est fournie et que le nom du poste de travail ou de l'application est fourni, start-session est l'action par défaut.
reset Éteint puis redémarre le poste de travail spécifié. 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. Cette action n'est pas valide pour une application.
logoff Déconnecte l'utilisateur du système d'exploitation invité sur le poste de travail distant. Cette action n'est pas valide pour une application.
restart Arrête et redémarre le poste de travail principal lorsque l'utilisateur confirme la demande d'opération de redémarrage. Cette action n'est pas valide pour une application.
applicationId
Nom affiché de l'application. Le nom complet est celui spécifié dans Horizon Administrator lors de la création du pool d'applications. Si le nom complet contient un espace, le navigateur utilise %20 pour représenter l'espace.
args
Spécifie des arguments de ligne de commande à ajouter au lancement d'applications distantes. Utilisez la syntaxe args= value, où value est une chaîne. Utilisez l'encodage avec pourcentage pour les caractères suivants :
  • Pour un deux-points (:), utilisez %3A
  • Pour une barre oblique inversée (\), 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.

desktopId
Nom affiché du poste de travail. Le nom complet est celui spécifié dans View Administrator lorsque le pool de postes de travail a été créé. Si le nom complet contient un espace, le navigateur utilise %20 pour représenter l'espace.
domainName
Nom de domaine NETBIOS associé à l'utilisateur qui se connecte à l'application ou au poste de travail distant. Utilisez par exemple monentreprise plutôt que monentreprise.com.
tokenUserName
Nom d'utilisateur RSA ou RADIUS. N'utilisez cette requête que si le nom d'utilisateur RSA ou RADIUS est différent du nom d'utilisateur Active Directory. Si vous ne spécifiez pas cette requête et que l'authentification RSA ou RADIUS est nécessaire, le nom d'utilisateur Windows est utilisé.
userName
Utilisateur Active Directory qui se connecte à l'application ou au poste de travail distant. Le nom d'utilisateur peut utiliser l'un des formats suivants :
  • userName
  • domainName%5CuserName
  • nom d'utilisateur principal (UPN), c'est-à-dire userName@domainName
unauthenticatedAccessEnabled
Si cette option est définie sur true, la fonctionnalité Accès non authentifié est activée par défaut. Le HTML Access Web client est lancé et un compte d'utilisateur anonyme s'affiche. Exemple de syntaxe : unauthenticatedAccessEnabled=true.
unauthenticatedAccessAccount
Définit le compte à utiliser si la fonctionnalité Accès non authentifié est activée. 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