Examples of URIs

With a URI, you can create hypertext links or buttons and include these links in an email message or on a web page. End users can click these links to open a particular remote desktop or published application with the startup options that you specify.

URI Syntax Examples

Each of the following URI examples 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.

```
https://horizon.mycompany.com/?domainName=finance&userName=fred
```
HTML Access starts 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.
```
https://horizon.mycompany.com/?userName=finance%5Cfred
```
HTML Access starts 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.
```
https://horizon.mycompany.com/?userName=fred@finance
```
HTML Access starts 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.
```
https://horizon.mycompany.com/?desktopId=Primary%20Desktop&action=start-session
```
HTML Access starts 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 remote desktop that has the display name Primary Desktop and the user is logged in to the guest operating system.
```
https://horizon.mycompany.com/?applicationId=Notepad&action=start-session
```
HTML Access starts 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 starts.
```
https://horizon.mycompany.com:7555/?desktopId=Primary%20Desktop
```
This URI has the same effect as the previous example, except that it uses the non-default port 7555 for the server. The default port is 443. Because a remote desktop identifier is provided, the remote desktop starts even though the start-session action is not included in the URI.
```
https://horizon.mycompany.com/?applicationId=Primary%20Application&desktopId=Primary%20Desktop
```
This URI specifies both a published application and a remote desktop. When you specify both a published application and a remote desktop, only the remote desktop starts.
```
https://horizon.mycompany.com/?desktopId=Primary%20Desktop&action=reset
```
HTML Access starts 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 a Horizon administrator has allowed end users to reset their machines.
```
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 start command. The filename is enclosed in double quotes because it contains spaces.
```
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 start 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 that 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.
```
https://horizon.mycompany.com/?desktopId=Primary%20Desktop&action=restart
```
HTML Access starts 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 a Horizon administrator has allowed end users to restart their machines.

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

HTML Access starts 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 reads Test Link and a button that reads 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>