User manual

Table Of Contents
You must have the correct version of FreeRDP installed, along with any applicable patches. For more
information, see “Install and Configure FreeRDP,” on page 38.
General Syntax
You can use the vmware-view command-line interface or some properties in configuration files to specify
options for xfreerdp, just as you can for rdesktop.
n
To specify that Horizon Client should run xfreerdp rather than rdesktop, use the appropriate
command-line option or configuration key.
Command-line option:
--rdpclient="xfreerdp"
Configuration key:
view.rdpClient="xfreerdp"
n
To specify options to forward to the xfreerdp program, use the appropriate command-line option or
configuration key, and specify the FreeRDP options.
Command-line option:
--xfreerdpOptions
Configuration key:
view.xfreerdpOptions
For more information about using the vmware-view command-line interface and configuration files, see
“Using the Horizon Client Command-Line Interface and Configuration Files,” on page 25.
Syntax for Network Level Authentication
Many configuration options for the rdesktop program are the same as for the xfreerdp program. One
important difference is that xfreerdp supports network-level authentication (NLA). NLA is turned off by
default. You must use the following command-line option to turn on network-level authentication:
--enableNla
Also, you must add the /cert-ignore option so that the certificate verification process can succeed.
Following is an example of the correct syntax:
vmware-view --enableNla --rdpclient=xfreerdp --xfreerdpOptions="/p:password /cert-ignore /u:user-
name /d:domain-name /v:server"
If the password contains any special characters, escape the special characters (for example: \$).
Syntax Specific to Using FreeRDP with Horizon Client
Keep the following guidelines in mind:
n
You must escape special characters that you might normally place in quotation marks. For example, the
following command does not work because the special character $ in pa$$word is not escaped:
(incorrect) vmware-view --rdpclient=xfreerdp --xfreerdpOptions="/p:'pa$
$word' /u:'crt\administrator'"
Instead, you must use:
(correct) vmware-view --rdpclient=xfreerdp --
xfreerdpOptions="/p:'pa\$\$word' /u:'crt\administrator'"
n
If end users will use a session-in-session implementation of Horizon Client, you must use the /rfx
option. An example of a session-in-session implementation is one in which an end user logs in to
Horizon Client on a thin client, so that the Horizon Client interface is the only one the end user sees,
and the end user then launches a nested version of Horizon Client in order to use a remote application
provided by an RDS host. In cases like this, if you do not use the /rfx option, the end user will not be
able to see the remote desktop and application icons in the desktop and application selector of the
nested client.
Chapter 2 Configuring Horizon Client for End Users
VMware, Inc. 37