After you register a machine in the Horizon Console, you can install the Horizon Agent without providing administrator credentials. The agent installer discovers the Connection Server automatically and completes the pairing process.
To install Horizon Agent using machine credential pairing:
-
Download the Horizon Agent installer from the Omnissa Customer Connect portal.
-
Run the installer.
-
Accept the license agreement.
-
Select the network protocol.
-
Select the features to install.
-
On the Register with Horizon Connection Server page, select one of the three pairing methods.
-
Manually enter the Horizon Connection Server details.
-
Auto-discover the Horizon Connection Server.
-
Enter the pod name of the pod you want the agent to join.
The following options are available when you auto-discover the connection server or enter the pod name:
Auto-discover Connection Server - Discover the Connection Server automatically. The machine must be pre-registered in Horizon Console. No credentials are required.
Enter the pod name - Specify the Connection Server pod. The machine must be pre-registered in Horizon Console. No credentials are required.
-
-
Complete the installation process based on the selected pairing method.
Install Horizon Agent Silently with Machine Credential Pairing
Horizon Agent can be installed silently on pre-registered machines without including administrator credentials in the command line. Use the VDM_PAIRING_MECHANISM property to specify the authentication method.
MSI Properties for Machine Credential Pairing
The following describes the MSI properties for configuring credential-free pairing during silent installation.
| Option | Action |
|---|---|
| VDM_PAIRING_MECHANISM | Specifies the pairing method.
1 = Specify Connection Server host name (default). Requires VDM_SERVER_NAME, VDM_SERVER_USERNAME, and VDM_SERVER_PASSWORD. 2 = Auto-discover Connection Server. No credentials required. 3 = Specify pod name. Requires VDM_POD_NAME. No credentials required. |
| VDM_POD_NAME | Specifies the pod name. Required when VDM_PAIRING_MECHANISM=3. |
Examples
Example 1: Auto-discover Connection Server
The following command installs the Horizon Agent and automatically discovers the Connection Server. The machine must be pre-registered in Horizon Console.
agent-installer.exe /s /v"/qn \ VDM_VC_MANAGED_AGENT=0 VDM_PAIRING_MECHANISM=2 \ ADDLOCAL=Core,ThinPrint,USB,RTAV,ClientDriveRedirection"
Example 2: Specify pod name
The following command installs the Horizon Agent and connects to the specified pod. Use this option in Cloud Pod Architecture environments.
agent-installer.exe /s /v"/qn \ VDM_VC_MANAGED_AGENT=0 VDM_PAIRING_MECHANISM=3 VDM_POD_NAME=Pod1 \ ADDLOCAL=Core,ThinPrint,USB,RTAV"
What to do next
After the agent installation completes and the machine restarts, the machine appears in the Registered Machines list in Horizon Console. You can then add the machine to a manual desktop pool.
-
To view registered machines, select Settings > Registered Machines > Others.
-
To create a manual desktop pool, see Create a Manual Desktop Pool.
Was this page helpful?