You can include specific properties when you silently install Horizon Agent from the command line. You must use a PROPERTY=value format so that Microsoft Windows Installer (MSI) can interpret the properties and values.
Table 1 shows the Horizon Agent silent installation properties that you can use at the command-line.
| MSI Property | Description | Default Value |
|---|---|---|
| INSTALLDIR | The path and folder in which the Horizon Agent software is installed. For example: INSTALLDIR=""D:\abc\my folder"" The sets of two double quotes that enclose the path permit the MSI installer to ignore the space in the path. This MSI property is optional. |
%ProgramFiles%\VMware\VMware View\Agent |
| RDP_CHOICE | Determines whether to enable Remote Desktop Protocol (RDP) on the desktop. A value of 1 enables RDP. A value of 0 leaves the RDP setting disabled. This MSI property is optional. |
1 |
| SUPPRESS_RUNONCE_CHECK | Ignores pending Windows Update tasks scheduled at the next OS reboot in HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\RunOnce and RunOnceEx keys. Using this flag allows concurrent installation but does not guarantee the installation outcome when the system updates affect the Horizon Agent run-time dependencies. This MSI property is optional. |
None |
| URL_FILTERING_ENABLED | Specifies whether the URL Content Redirection feature is installed. A value of 1 installs the feature. You must then use group policy settings to configure which URLs to redirect. See "Configuring URL Content Redirection in the Configuring Remote Desktop Features in Horizon 7 document. This MSI property is optional. |
0 |
| VDM_SKIP_BROKER_REGISTRATION | A value of 1 skips unmanaged desktops. | None |
| VDM_VC_MANAGED_AGENT | Determines whether vCenter Server manages the virtual machine on which Horizon Agent is installed. A value of 1 configures the desktop as a vCenter Server-managed virtual machine. A value of 0 configures the desktop as unmanaged by vCenter Server. This MSI property is required. |
None |
| VDM_SERVER_NAME | The host name or IP address of the View Connection Server computer on which the Horizon Agent installer registers an unmanaged desktop. This property applies to unmanaged desktops only. For example: VDM_SERVER_NAME=10.123.01.01 This MSI property is required for unmanaged desktops. Do not use this MSI property for virtual-machine desktops that are managed by vCenter Server. |
None |
| VDM_SERVER_USERNAME | The user name of the administrator on the View Connection Server computer. This MSI property applies to unmanaged desktops only. For example: VDM_SERVER_USERNAME=domain\username This MSI property is required for unmanaged desktops. Do not use this MSI property for virtual-machine desktops that are managed by vCenter Server. |
None |
| VDM_SERVER_PASSWORD | The View Connection Server administrator user password. For example: VDM_SERVER_PASSWORD=secret This MSI property is required for unmanaged desktops. Do not use this MSI property for virtual-machine desktops that are managed by vCenter Server. |
None |
| VDM_IP_PROTOCOL_USAGE | Specifies the IP version that Horizon Agent uses. The possible values are IPv4 and IPv6. | IPv4 |
| VDM_FIPS_ENABLED | Specifies whether to enable or disable FIPS mode. A value of 1 enables FIPS mode. A value of 0 disables FIPS mode. If this property is set to 1 and Windows is not in FIPS mode, the installer will abort. | 0 |
| VDM_FLASH_URL_REDIRECTION | Determines whether Horizon Agent can install the Flash URL redirection feature. Specify 1 to enable installation or 0 to disable installation. This MSI property is optional. |
0 |
| INSTALL_VDISPLAY_DRIVER | Configures the Horizon WDDM display driver. A value of 1 enables the driver installation. A value of 0 or empty disables the driver installation | 0 |
In a silent installation command, you can use the MSI property, ADDLOCAL=, to specify options that the Horizon Agent installer configures.
Table 2 shows the Horizon Agent options you can type at the command line. These options have corresponding setup options that you can deselect or select during an interactive installation.
For details about the custom setup options, see Horizon Agent Custom Setup Options for an RDS Host.
When you do not use the ADDLOCAL property at the command line, Horizon Agent installs all options that are installed by default during an interactive installation, if they are supported on the guest operating system. When you use ADDLOCAL=ALL, Horizon Agent installs all of the following options, both on-by-default and off-by-default, if they are supported on the guest operating system, except NGVC. NGVC and SVIAgent are mutually exclusive. To install NGVC, you must specify it explicitly.
For details, see the ADDLOCAL table entry in Microsoft Windows Installer Command-Line Options in Setting Up Virtual Desktops in Horizon 7
| Silent Installation Option | Custom Setup Option in an Interactive Installation | Installed by Default Interactively or When ADDLOCAL Is Not Used |
|---|---|---|
| Core | Core | Yes |
| USB | USB Redirection | No |
| SVIAgent | View Composer Agent | Yes |
| NGVC | Instant Clone Agent | No |
| RTAV | Real-Time Audio-Video | Yes |
| ClientDriveRedirection | Client Drive Redirection | Yes |
| SerialPortRedirection | Serial Port Redirection | No |
| ScannerRedirection | Scanner Redirection | No |
| FlashURLRedirection | Flash URL Redirection This feature is hidden unless you use the VDM_FLASH_URL_REDIRECTION=1 property on the command line. |
No |
| ThinPrint | Virtual Printing | Yes |
| V4V | vRealize Operations Desktop Agent | Yes |
| VPA | View Persona Management | Yes |
| SmartCard | PCoIP Smartcard. This feature is not installed by default in an interactive installation. | No |
| VmwVaudio | VMware Audio (virtual audio driver) | Yes |
| TSMMR | Windows Media Multimedia Redirection (MMR) | Yes |
| RDP | This feature enables RDP in the registry if you use the RDP_CHOICE=1 property on the command line or select RDP as the default display protocol when you create or edit a desktop pool in View Administrator. This feature is hidden during interactive installations. |
Yes |
| VMWMediaProviderProxy | VMware Virtualization Pack for Skype for Business feature. | No |
If you use ADDLOCAL to specify features individually, that is, you do not specify ADDLOCAL=ALL, you must always specify Core.
| Silent Installation Feature | Description |
|---|---|
| Core | The core Horizon Agent functions. If you specify ADDLOCAL=ALL, the Core features are installed. |
| BlastProtocol | VMware Blast |
| PCoIP | PCoIP Protocol Agent |
| VmVideo | Virtual video driver |
| UnityTouch | Unity Touch |
| PSG | This features sets a registry entry that tells Connection Server whether Horizon Agent is using IPv4 or IPv6. |
You install the Flash URL Redirection feature by using the VDM_FLASH_URL_REDIRECTION=1 property in a silent installation. This feature is not installed during an interactive installation or by using ADDLOCAL=ALL in a silent installation.
For example: VMware-viewagent-y.y.y-xxxxxx.exe /s /v"/qn VDM_VC_MANAGED_AGENT=1 VDM_FLASH_URL_REDIRECTION=1 ADDLOCAL=Core,SVIAgent,ThinPrint,USB,FlashURLRedirection,RTAV"
