To install Horizon Client silently, you must use Microsoft Windows Installer (MSI) command-line options and properties. The Horizon Client installers are MSI programs and use standard MSI features. You can also use MSI command-line options to uninstall Horizon Client silently.

For details about MSI, see the Microsoft Web site. For MSI command-line options, see the Microsoft Developer Network (MSDN) Library Web site and search for MSI command-line options. To see MSI command-line usage, you can open a command prompt on the client computer and type msiexec /?.

To run the Horizon Client installer silently, you begin by silencing the bootstrap program that extracts the installer into a temporary directory and starts an interactive installation.

The following table shows the command-line options that control the installer's bootstrap program.

Table 1. Command-Line Options for the Bootstrap Program

Option

Description

/s

Disables the bootstrap splash screen and extraction dialog box, which prevents the display of interactive dialogs.

For example: VMware-Horizon-Client-y.y.y-xxxxxx.exe /s

The /s option is required to run a silent installation. In the examples, xxxxxx is the build number and y.y.y is the version number.

/v" MSI_command_line_options"

Instructs the installer to pass the double-quote-enclosed string that you enter at the command line as a set of options for MSI to interpret. You must enclose your command-line entries between double quotes. Place a double quote after the /v and at the end of the command line.

For example: VMware-Horizon-Client-y.y.y-xxxxxx.exe /s /v"command_line_options"

To instruct the MSI installer to interpret a string that contains spaces, enclose the string in two sets of double quotes. For example, you might want to install the client in an installation path name that contains spaces.

For example: VMware--Horizon-View-Client-y.y.y-xxxxxx.exe /s /v"command_line_options INSTALLDIR=""d:\abc\my folder"""

In this example, the MSI installer passes on the installation-directory path and does not attempt to interpret the string as two command-line options. Note the final double quote that encloses the entire command line.

The /v"command_line_options" option is required to run a silent installation.

You control the remainder of a silent installation by passing command-line options and MSI property values to the MSI installer, msiexec.exe. The MSI installer includes Horizon Client installation code. The installer uses the values and options that you enter in the command line to interpret installation choices and setup options that are specific to Horizon Client.

The following table shows the command-line options and MSI property values that are passed to the MSI installer.

Table 2. MSI Command-Line Options and MSI Properties

MSI Option or Property

Description

/qn

Instructs the MSI installer not to display the installer wizard pages.

For example, you might want to install the agent silently and use only default setup options and features:

VMware-Horizon-Client-y.y.y-xxxxxx.exe /s /v"/qn"

In the examples, xxxxxx is the build number and y.y.y is the version number.

Alternatively, you can use the /qb option to display the wizard pages in a noninteractive, automated installation. As the installation proceeds, the wizard pages are displayed, but you cannot respond to them.

The /qn or /qb option is required to run a silent installation.

INSTALLDIR

(Optional) Specifies an alternative installation path for installation directory.

Use the format INSTALLDIR=path to specify an installation path. You can ignore this MSI property if you want to install the client in the default path.

ADDLOCAL

(Optional) Determines the component-specific features to install. In an interactive installation, the installer displays custom setup options to select. The MSI property, ADDLOCAL, lets you specify these setup options on the command line.

To install all available custom setup options, enter ADDLOCAL=ALL.

For example: VMware-Horizon-Client-y.y.y-xxxxxx.exe /s /v"/qn ADDLOCAL=ALL"

If you do not use the MSI property, ADDLOCAL, the default setup options are installed.

To specify individual setup options, enter a comma-separated list of setup option names. Do not use spaces between names. Use the format ADDLOCAL=value,value,value....

For example, you might want to install the client with the USB Redirection feature but without the Log in as Current User feature:

VMware-Horizon-Client-y.y.y-xxxxxx.exe /s /v"/qn ADDLOCAL=Core,USB"

LOGINASCURRENTUSER_DISPLAY

(Optional) Determines whether the Log in as current user check box is visible on the Horizon Client connection dialog box.

Valid values are 1 (enabled) and 0 (disabled). The default is 1, which means that the check box is visible, and users can select or deselect it and override its default value. When the check box is hidden, users cannot override its default value from the Horizon Client connection dialog box.

LOGINASCURRENTUSER_DEFAULT

(Optional) Specifies the default value of the Log in as current user check box on the Horizon Client connection dialog box. Valid values are 1 (enabled) and 0 (disabled). No default is set, which means that the check box is deselected, and users must provide identity and credential information multiple times before they can access a remote desktop.

When the Log in as current user check box is selected, the identity and credential information that the user provided when logging in to the client system is passed to the View Connection Server instance and ultimately to the remote desktop.

Use this option in conjunction with the LOGINASCURRENTUSER_DISPLAY option. For example: LOGINASCURRENTUSER_DISPLAY=1 LOGINASCURRENTUSER_DEFAULT=1

If a user runs Horizon Client from the command line and specifies the logInAsCurrentUser option, that value overrides this setting.

REBOOT

(Optional) You can use the REBOOT=ReallySuppress option to suppress all restarts and restart prompts.

/l*v log_file

(Optional) Writes logging information into the specified log file.

For example: /l*v ""%TEMP%\vmmsi.log""

This example generates a detailed log file that is similar to the log generated during an interactive installation.

You can use this option to record custom features that might apply uniquely to your installation. You can use the recorded information to specify installation features in future silent installations.

Installation Examples

In the following examples, xxxxxx is the build number, y.y.y is the version number, install_folder is the path to the installation folder, and view.mycompany.com is the name of a fictitious View Connection Server instance.

Default installation example:

VMware-Horizon-Client-x86_64-y.y.y-xxxxxx.exe /s /v"/qn REBOOT=ReallySuppress INSTALLDIR=install_folder ADDLOCAL=ALL DESKTOP_SHORTCUT=1 STARTMENU_SHORTCUT=1 VDM_SERVER=view.mycompany.com /l*v "%TEMP%\log.txt""

Installation and configuration example for the Log In as Current User feature:

VMware-Horizon-Client-x86_64-y.y.y-xxxxxx.exe /s /v"/qn INSTALLDIR=install_folder ADDLOCAL=Core,TSSO LOGINASCURRENTUSER_DISPLAY=1 LOGINASCURRENTUSER_DEFAULT=1 DESKTOP_SHORTCUT=1 STARTMENU_SHORTCUT=1 VDM_SERVER=view.mycompany.com /l*v "%TEMP%\log.txt"" 

In this example, REBOOT=ReallySuppress is omitted because the TSSO (log in as the currently logged-in Windows domain user) option requires a reboot.