Deploy Unified Access Gateway to Azure with the `uagdeployaz.ps1` PowerShell command

You can deploy Unified Access Gateway to Azure with the PowerShell command.

Procedure

1. 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.

2. Extract the files from the zip file. Ensure that the following PowerShell scripts are available on your machine.
   uagdeployaz.ps1 and uagdeploy.psm1

3. Open PowerShell window and run the command.

   uagdeployaz.ps1 uag1.ini
   

Azure deployment when using PowerShell 5

The support for AzureRM module is deprecated by Microsoft. When the Unified Access Gateway script detects a PowerShell 5 environment, it uses uagdeployaz.ps1 script built with the AzureRM module. While executing uagdeployaz.ps1 using PowerShell 5, you might see the following warning message:

The AzureRM PowerShell module has been officially deprecated as of February 29, 2024. Users are advised to migrate from AzureRM to the Az PowerShell module to ensure continued support and updates.

To work around this issue, use the uagdeployaz_ps7.ps1 script which is built with Az module.

Workaround

1. Run this command to uninstall the AzureRM module.

   uninstall-module AzureRM
   $Modules = Get-Module -ListAvailable | Where {$_.Name -like 'AzureRM.*'}
   Foreach ($Module in $Modules) {Uninstall-Module $Module}
   

2. Install the Az module. For more information, see Install Azure PowerShell on Windows.
3. Rename the downloaded file uagdeployaz_ps7.ps1 to uagdeployaz.ps1.
4. Run the command.

   uagdeployaz.ps1 uag1.ini