Syntax includes a path part to specify the server, and, optionally, a query to specify a user, desktop or application, and 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 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 document for each type of client system.

args
Specifies command-line arguments to add to remote application launch. Use the syntax args= value, where value is a string. Use percent encoding for the following characters:
  • For a colon (:), use %3A
  • For a back slash (\), use %5C
  • For a space ( ), use %20
  • For a double quotation mark ("), use %22

For example, to specify the filename "My new file.txt" for the Notepad++ application, use %22My%20new%20file.txt%22.

desktopId
The desktop display name. The display name is the name specified in View Administrator when the desktop pool was created. If the display name has a space in it, the browser uses %20 to represent the space.
domainName
The NETBIOS domain name associated with the user who is connecting to the remote desktop or application. For example, use mycompany rather than mycompany.com.
userName
The Active Directory user who is connecting to the remote desktop or application. The user name can be in one of the following formats:
  • userName
  • domainName%5CuserName
  • user principal name (UPN), that is, userName@domainName
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.
applicationId
The application display name. The display name is the name specified in Horizon Administrator when the application pool was created. If the display name has a space in it, the browser uses %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 and applications hosted on the specified server. You are not required to specify a desktop or application when using this action.
start-session Starts the specified desktop or application. If no action query is provided and the desktop or application name is provided, start-session is the default action.
reset Shuts down and restarts the specified desktop. Unsaved data is lost. Resetting a remote desktop is the equivalent of pressing the Reset button on a physical PC. This action is not valid for an application.
logoff Logs the user out of the guest operating system in the remote desktop. This action is not valid for an application.
restart Shuts down and restarts the primary desktop after the user confirms the restart operation request. This action is not valid for an application.