July 23, 2026

PowerShell deployment to vSphere

Unified Access Gateway supports vSphere deployments for secure remote access to Horizon and Workspace ONE environments.

Pre-requisites to deploy Unified Access Gateway on vSphere

Adequate privileges to deploy virtual machine on vCenter.
Downloaded.ova file.
From the Omnissa Customer Connect, go to Unified Access Gateway (UAG) for vSphere, AWS, Google Cloud, and Nutanix file and click DOWNLOAD NOW. A zip file euc-unified-access-gateway-x.x.x.xxxxxxxxx.ova is downloaded on your local machine.

Recommended Operating Systems for running the PowerShell deployment script

The following table lists the operating systems from which PowerShell based Unified Access Gateway deployment to vSphere can be executed. This does not refer to the operating system of the Unified Access Gateway appliance itself.

Operating System	Recommended OS Version
Windows	10 and 11
Ubuntu	20.04, 22.04, 24.04

Prepare the .ini file

To prepare the .ini file, configure the General settings, including the parameters mentioned in the following table.

For more information about configuring other [General] section parameters, see PowerShell deployment parameters.

vSphere specific settings

Ensure to configure these additional parameters for the deployment.

INI Parameter	Description
folder	Specifies the folder where VM is created. Deploys the appliance in the named VMs and Templates folder. Folders in vCenter are shown under VMs and Templates. The folder specified must exist before deployment.
ds	Datastore name which the appliance is deployed to. Example: `ds=Local Disk 1`
netBackendNetwork	The name of the UAG backend network.
netInternet	The name of the UAG primary network.
netManagementNetwork	The name of the UAG management interface network.
source	Use the source file you previously downloaded from the Customer Connect portal. Enter the full path filename or remote URL of the UAG .`ova` virtual machine image. Example: Local - `C:\Users\Administrator\Desktop\UAG Resources\euc-unified-access-gateway-25.06.0.0-15261880358_OVF10.ova` URL based - `https://fileserver.example.com/images/uag/euc-unified-access-gateway-25.06.0.0-15261880358_OVF10.ova`
target	Specifies the vCenter Server information and target ESX host. Refer to the OVF Tool User's Guide for details of the syntax of target. The target must reference a vCenter host or cluster. Deploying directly to a vSphere host is not supported. Example:`target=vi://administrator@vsphere.local@192.168.0.21/DC1/host/my folder/esx1.myco.int` In this example, 192.168.0.21 is the IP address of the vCenter host and `administrator@vsphere.local` is the vCenter administrator user name. Folder names, host names, and cluster names used in the target value are case-sensitive. If you are unsure of the value to use for the target, you can omit folder names and so on and the OVF Tool will then provide a list of possible values for the next level. This allows you to accurately build up the full target specification one level at a time.

Deploy Unified Access Gateway to vSphere

You can deploy Unified Access Gateway to vSphere by using the uagdeploy.ps1 PowerShell command.

From the Omnissa Customer Connect, go to Unified Access Gateway (UAG) PowerShell Scripts file and click DOWNLOAD NOW.
A zip file uagdeploy-xx.xx.x.x-xxxxxxxx is downloaded on your local machine.
Extract the files from the zip file. Ensure that the following PowerShell script is available on your machine.
uagdeploy.ps1
Open PowerShell window and run the following command:
.\uagdeploy.ps1 vsphere.ini
Enter the root user password, admin password when prompted. For more information about the root user and admin password requirements, see Password requirements.
After successful deployment, virtual machine is created the vCenter.

What's Next

Using the IP information, login to the virtual machine to ensure all services are working as expected.
Login to the admin UI with https://uag-ip:9443 and configure the settings based on your requirement. See Configure Horizon Settings.

Was this page helpful?