Syntax includes a path part to specify the server, and, optionally, a query to specify the user, desktop, and desktop actions or configuration options.

URI Specification

Use the following syntax to create URIs for launching HTML Access Web clients:

https://authority-part[/?query-part]

authority-part

Specifies the server address and, optionally, a non-default port number. Server names must conform to DNS syntax.

To specify a port number, use the following syntax:

server-address:port-number

query-part

Specifies the configuration options to use or the desktop actions to perform. Queries are not case-sensitive. To use multiple queries, use an ampersand (&) between the queries. If queries conflict with each other, the last query in the list is used. Use the following syntax:

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

Observe the following guidelines when creating the query-part:

  • If you do not use at least one of the supported queries, the default VMware Horizon Web portal page is displayed.

  • In the query part, some special characters are not supported, and you must use the URL encoding format for them, as follows: For the pound symbol (#) use %23, for the percent sign (%) use %25, for the ampersand (&) use %26, for the at sign (@) use %40, and for the backslash (\) use %5C.

    For more information about URL encoding, go to http://www.w3schools.com/tags/ref_urlencode.asp.

  • In the query part, non-ASCII characters must first be encoded according to UTF-8 [STD63], and then each octet of the corresponding UTF-8 sequence must be percent-encoded to be represented as URI characters.

    For information about encoding for ASCII characters, see the URL encoding reference at http://www.utf8-chartable.de/.

Supported Queries

This topic lists the queries that are supported for the HTML Access Web client. If you are creating URIs for multiple types of clients, such as desktop clients and mobile clients, see the Using VMware Horizon Client guide for each type of client system.

domainName

The NETBIOS domain name associated with the user who is connecting to the remote desktop. For example, you would use mycompany rather than mycompany.com.

userName

The Active Directory user who is connecting to the remote desktop.

tokenUserName

The RSA or RADIUS user name. Use this query only if the RSA or RADIUS user name is different from the Active Directory user name. If you do not specify this query and RSA or RADIUS authentication is required, the Windows user name is used.

desktopId

The desktop display name. This name is the one specified in View Administrator when the desktop pool was created. If the display name has a space in it, the browser will automatically use %20 to represent the space.

action

Table 1. Values That Can Be Used with the action Query

Value

Description

browse

Displays a list of available desktops hosted on the specified server. You are not required to specify a desktop when using this action.

start-session

Launches the specified desktop. If no action query is provided and the desktop name is provided, start-session is the default action.

reset

Shuts down and restarts the specified desktopn. Unsaved data is lost. Resetting a remote desktop is the equivalent of pressing the Reset button on a physical PC.

logoff

Logs the user out of the guest operating system in the remote desktop.