You can create hypertext links or buttons with a URI and include these links in email or on a Web page. Your end users can click these links to, for example, open a particular remote desktop or application with the startup options you specify.

URI Syntax Examples

Each URI example is followed by a description of what the end user sees after clicking the URI link. Queries are not case-sensitive. For example, you can use domainName or domainname.

  1. https://horizon.mycompany.com/?domainName=finance&userName=fred

    The HTML Access Web client is launched and connects to the horizon.mycompany.com server. In the login box, the User name text box is populated with the name fred, and the Domain text box is populated with finance. The user must supply only a password.

  2. https://horizon.mycompany.com/?userName=finance%5Cfred

    The HTML Access Web client is launched and connects to the horizon.mycompany.com server. In the login box, the User name text box is populated with the name finance\fred. The user must supply only a password.

  3. https://horizon.mycompany.com/?userName=fred@finance

    The HTML Access Web client is launched and connects to the horizon.mycompany.com server. In the login box, the User name text box is populated with the name fred@finance. The user must supply only a password.

  4. https://horizon.mycompany.com/?desktopId=Primary%20Desktop&action=start-session

    The HTML Access Web client is launched and connects to the horizon.mycompany.com server. The login box prompts the user for a user name, domain name, and password. After a successful login, the client connects to the desktop whose display name is displayed as Primary Desktop, and the user is logged in to the guest operating system.

  5. https://horizon.mycompany.com/?applicationId=Notepad&action=start-session

    The HTML Access Web client is launched and connects to the horizon.mycompany.com server. The login box prompts the user for a user name, domain name, and password. After a successful login, the Notepad application is launched.

  6. https://horizon.mycompany.com:7555/?desktopId=Primary%20Desktop

    This URI has the same effect as the previous example, except that it uses the nondefault port of 7555 for Connection Server. (The default port is 443.) Because a desktop identifier is provided, the desktop is launched even though the start-session action is not included in the URI.

  7. https://horizon.mycompany.com/?applicationId=Primary%20Application&desktopId=Primary%20Desktop

    This URI specifies both an application and a desktop. When you specify both an application and a desktop, only the desktop is launched.

  8. https://horizon.mycompany.com/?desktopId=Primary%20Desktop&action=reset

    The HTML Access Web client is launched and connects to the horizon.mycompany.com server. The login box prompts the user for a user name, domain name, and password. After a successful login, the client displays a dialog box that prompts the user to confirm the reset operation for Primary Desktop.

    Note:

    This action is available only if the Horizon administrator has allowed end users to reset their machines.

  9. https://horizon.mycompany.com/?My%20Notepad++?args=%22My%20new%20file.txt%22

    Opens My Notepad++ on server horizon.mycompany.com and passes the argument My new file.txt in the application launch command. The filename is enclosed in double quotes because it contains spaces.

  10. https://horizon.mycompany.com/?Notepad++%2012?args=a.txt%20b.txt

    Opens Notepad++ 12 on server horizon.mycompany.com and passes the argument a.text b.txt in the application launch command. Because the argument is not enclosed in double quotes, a space separates the filenames and the two files are opened separately in Notepad++.

    Note:

    Applications can differ in the way they use command-line arguments. For example, if you pass the argument a.txt b.txt to WordPad, WordPad opens only one file, a.txt.

  11. https://horizon.mycompany.com/?desktopId=Primary%20Desktop&action=restart

    The HTML Access Web client is launched and connects to the horizon.mycompany.com server. The login box prompts the user for a user name, domain name, and password. After a successful login, the client displays a dialog box that prompts the user to confirm the restart operation for Primary Desktop.

    Note:

    This action is available only if the Horizon administrator has allowed end users to restart their machines.

  12. https://horizon.mycompany.com/?unauthenticatedAccessEnabled=true&unauthenticatedAccessAccount=anonymous_user1

    The HTML Access Web client is launched and connects to the horizon.mycompany.com server using the anonymous_user1 account.

HTML Code Examples

You can use URIs to make hypertext links and buttons to include in emails or on Web pages. The following examples show how to use the URI from the first URI example to code a hypertext link that says, Test Link, and a button that says, TestButton.

<html>
<body>

<a href="https://horizon.mycompany.com/?domainName=finance&userName=fred">Test Link</a><br>

<form><input type="button" value="TestButton" onClick="window.location.href=
'https://horizon.mycompany.com/?domainName=finance&userName=fred'"></form> <br>

</body>
</html>