You can create hypertext links or buttons with the vmware-view URI scheme 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 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.

  1. vmware-view://view.mycompany.com/Primary%20Desktop?action=start-session

    Horizon Client starts and connects to the view.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.

    Note:

    The default display protocol and window size are used. The default display protocol is PCoIP. The default window size is full screen.

  2. vmware-view://view.mycompany.com:7555/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 opens even though the start-session action is not included in the URI.

  3. vmware-view://fred@view.mycompany.com/Finance%20Desktop?desktopProtocol=PCOIP

    Horizon Client starts and connects to the view.mycompany.com server. In the login box, the User name text box is populated with the name fred. The user must supply the domain name and password. After a successful login, the client connects to the desktop whose display name is displayed as Finance Desktop, and the user is logged in to the guest operating system. The connection uses the PCoIP display protocol.

  4. vmware-view://view.mycompany.com/Calculator?action=start-session&appProtocol=BLAST

    Horizon Client starts and connects to the view.mycompany.com server. In the login box, the user must supply the user name, domain name, and password. After a successful login, the client connects to the application whose display name is displayed as Calculator. The connection uses the VMware Blast display protocol.

  5. vmware-view://fred@view.mycompany.com/Finance%20Desktop?domainName=mycompany

    Horizon Client starts and connects to the view.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 mycompany. The user must supply only a password. After a successful login, the client connects to the desktop whose display name is displayed as Finance Desktop, and the user is logged in to the guest operating system.

  6. vmware-view://view.mycompany.com/

    Horizon Client starts and the user is taken to the login prompt for connecting to the view.mycompany.com server.

  7. vmware-view://view.mycompany.com/Primary%20Desktop?action=reset

    Horizon Client starts and connects to the view.mycompany.com server. The login box prompts the user for a user name, domain name, and password. After a successful login, Horizon Client displays a dialog box that prompts the user to confirm the reset operation for Primary Desktop. After the reset occurs, depending on the type of client, the user might see a message that indicates whether the reset was successful.

    Note:

    This action is available only if a View administrator has enabled this feature for end users.

  8. vmware-view://

    If the client is already running, the Horizon Client application comes to the foreground. If the client is not already running, Horizon Client starts.

  9. vmware-view://?defaultlaunchview=recent

    Horizon Client starts and the user sees the Recent screen.

  10. vmware-view://10.10.10.10/My%20Notepad++?args=%22My%20new%20file.txt%22

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

  11. vmware-view://10.10.10.10/Notepad++%2012?args=a.txt%20b.txt

    Launches Notepad++ 12 on server 10.10.10.10 and passes the argument a.text b.txt in the application launch command. Because the argument is not enclosed in 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 will open only one file, a.txt.

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="vmware-view://view.mycompany.com/Primary%20Desktop?action=start-session">Test Link</a><br>

<form><input type="button" value="TestButton" onClick="window.location.href=
'vmware-view://view.mycompany.com/Primary%20Desktop?action=start-session'"></form> <br>

</body>
</html>