Chapter 6: Unified Access Gateway deployment using the PowerShell


This is an overview of deploying the Unified Access Gateway script for VMware Horizon

  1. On your ControlCenter server,
    • Go to the Downloads folder
    • Select and open the uagdeploy folder and observe the contents    


  1. Select the uag2-Advanced.ini,
    • Copy and Paste so that you have a backup of the original file .
  1. Select uag2-advanced and then select Edit with Notepad++
  1. In the NotePad++ application
    • Next to name change to UAG-HZN
    • Next to source change
  • Next to target change it to:
target=vi://[email protected]:[email protected]/RegionA01/host/RegionA01-COMP01/
  1. Scroll down in your NotePad++ window
    • Next to ds=Local Disk 1 change to ds=CorpLUN
    • Next to #diskMode=thin change to diskMode=thin
    • Change the following network settings to:
      • netInternet=VL-DMZ
      • netManagementNetwork=VL-DMZ
      • netBackendNetwork=VL-DMZ
      • defaultGateway=
      • deploymentOption=onenic
      • ip0=
      • netmask0=
      • routes0=
  1. Scroll Down
    • Change dns= to


  1. Under [SSLCert] Change pfxCerts=sslcerts.pfx to
  1. In the [SSLCertAdmin] section , change pfxCerts=sslcerts.pfx to
  1. Under the [Horizon] section change proxyDestinationUrl= to
  1. Scroll down and Change
  • tunnelExternalUrl=
  • blastExternalUrl=




  1. Scroll down and Change
    • In the pcoipExternalUrl section change pcoipExternalUrl= to:
  1. SAVE THE .ini File


Part 2

In this section, we will deploy the Unified Access Gateway using a Powershell Script

  1. On your ControlCenter server ,
    • Launch the powershell shortcut from the Start Menu
  1. We will set the script execution is set to unrestricted. Execute the following command.
 Set-ExecutionPolicy -scope currentuser unrestricted
When Prompted select Y
  1. Within the powershell interface type the following command
 cd downloads\uagdeploy
  1. Execute the following command
.\uagdeploy.ps1 -iniFile uag2-advanced.ini
  • When you get a security warning type: R
  • When you get a second security warning type: R
  • When prompted to enter a root password for UAG-HZN,
    • type:- VMware1!
    • when prompted to confirm type VMware1!
  1. When prompted to
    • Enter an optional admin password for the RESP API management access for UAG: type VMware1!
    • When prompted to Re-Enter an optional admin password : type VMware1!
    • When prompted whether or not to join the customer experience program type No
  1. When prompted to
    • Enter password for the .pfx type: VMware1!,
    • When prompted to confirm type VMware1! again. 
    • When prompted the password for [email protected]
      • Type VMware1!
    • When prompted for fingerprint will be added to the known host file type yes
    • Your virtual Appliance deployment will now start , it will take between 5 - 10min to deploy. Proceed to step 8
  1. Review the deployment once the setup has completed
  1. On your ControlCenter server
    • Open your Chrome Browser. Select the vCenter shortcut
      • Login as administrator with the password VMware1!
      • Select the Host & Clusters Icon
      • In Host & Clusters, expand the inventory under RegionA01-COMP01
    • Switch Back to your Powershell window to check if the deployment has completed.
  1. On your ControlCenter server
    • On your Chrome Browser open a new Tab
    • Enter the following URL into the address bar
    • In the right of your Chrome Browser . Add the following URL as Favourite in your Bookmarks, by selecting the STAR.
    • Login to your UAG server by entering the following
      • Admin Username : admin
      • Admin Password: VMware1!
      • Select Login


  1. On your UAG Admin Console
    • Click the Select button under Configure Manually
  1. On your UAG Admin Console
    • Under General Settings
      • Next to Edge Service Settings, move the toggle to the right
  1. On your UAG Admin Console
    • To the right of Horizon Settings, select the Gearbox
  1. In your UAG Admin Console
    • Under Horizon Settings
      • Browse and familiarize yourself with config, we will be changing some of the settings in a future exercise
        • Logout from the UAG Admin Console

This concludes the deployment of the Unified Access Gateway using a Powershell Script

About the Author

About the Author Reinhart Nel

For any questions please email Reinhart at [email protected]


Add your comment

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.