Adaptive Gateway Selection
Explanation
Adaptive Gateway Selection enables Citrix Workspace app to automatically detect and connect to the best Citrix Gateway Service Point of Presence (PoP) based on current connection conditions.
If latency exceeds the Latency Threshold (expressed in milliseconds) for longer than the Latency Breach Duration (expressed in seconds), the app initiates a new Gateway Selection.
The Wi-Fi Signal Strength Threshold defines the minimum signal needed to perform a gateway selection (expressed as a percentage). If the signal falls below this level, gateway selection will not occur.
Registry
HKEY_LOCAL_MACHINE\Software\Policies\Citrix\ICA Client\Engine- Value name
AdaptiveGatewaySelection_Enabled
| State | Value written | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Enabled | REG_DWORD = 1
| ||||||||||||
| Disabled | REG_DWORD = 0
|
PowerShell
PowerShell commands that write to the registry what the policy would write. Values in angle brackets (<…>) must be replaced.
Writing directly to the registry bypasses Group Policy: if a GPO manages this value, it will be rewritten at the next gpupdate; otherwise the value stays in place (the "tattooing" effect). Prefer a GPO or, locally, LGPO.exe. Run PowerShell as administrator for HKLM. Some policies need a restart or gpupdate /force.
Enable
# Enable: receiver/Policy_AdaptiveGatewaySelection
$k = 'HKLM:\Software\Policies\Citrix\ICA Client\Engine'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
Set-ItemProperty -Path $k -Name 'AdaptiveGatewaySelection_Enabled' -Value 1 -Type DWord
Set-ItemProperty -Path $k -Name 'AdaptiveGatewaySelection_ThresholdHighLatency' -Value 300 -Type DWord
Set-ItemProperty -Path $k -Name 'AdaptiveGatewaySelection_ThresholdMinTime' -Value 30 -Type DWord
Set-ItemProperty -Path $k -Name 'AdaptiveGatewaySelection_ThresholdWifiSignalStrength' -Value 30 -Type DWord
# Latency Threshold
Set-ItemProperty -Path $k -Name 'AdaptiveGatewaySelection_ThresholdHighLatency' -Value 300 -Type DWord # between 1 and 5000
# Latency Breach Duration
Set-ItemProperty -Path $k -Name 'AdaptiveGatewaySelection_ThresholdMinTime' -Value 30 -Type DWord # between 0 and 3600
# Wi-Fi Signal Strength Threshold
Set-ItemProperty -Path $k -Name 'AdaptiveGatewaySelection_ThresholdWifiSignalStrength' -Value 30 -Type DWord # between 0 and 100Disable
# Disable: receiver/Policy_AdaptiveGatewaySelection
$k = 'HKLM:\Software\Policies\Citrix\ICA Client\Engine'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
Set-ItemProperty -Path $k -Name 'AdaptiveGatewaySelection_Enabled' -Value 0 -Type DWord
Remove-ItemProperty -Path $k -Name 'AdaptiveGatewaySelection_ThresholdHighLatency' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'AdaptiveGatewaySelection_ThresholdMinTime' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'AdaptiveGatewaySelection_ThresholdWifiSignalStrength' -ErrorAction SilentlyContinueRevert to "Not configured"
# Revert to "Not configured": receiver/Policy_AdaptiveGatewaySelection
$k = 'HKLM:\Software\Policies\Citrix\ICA Client\Engine'
Remove-ItemProperty -Path $k -Name 'AdaptiveGatewaySelection_Enabled' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'AdaptiveGatewaySelection_ThresholdHighLatency' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'AdaptiveGatewaySelection_ThresholdMinTime' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'AdaptiveGatewaySelection_ThresholdWifiSignalStrength' -ErrorAction SilentlyContinueOptions (3)
| Label | Control | Registry value | REG type | Constraints / details |
|---|---|---|---|---|
| Latency ThresholdAdaptiveGatewaySelection_ThresholdHighLatency | Numeric boxdecimal | AdaptiveGatewaySelection_ThresholdHighLatency | REG_DWORD | Required · Min: 1 · Max: 5000 · Default (UI): 300 |
| Latency Breach DurationAdaptiveGatewaySelection_ThresholdMinTime | Numeric boxdecimal | AdaptiveGatewaySelection_ThresholdMinTime | REG_DWORD | Required · Min: 0 · Max: 3600 · Default (UI): 30 |
| Wi-Fi Signal Strength ThresholdAdaptiveGatewaySelection_ThresholdWifiSignalStrength | Numeric boxdecimal | AdaptiveGatewaySelection_ThresholdWifiSignalStrength | REG_DWORD | Required · Min: 0 · Max: 100 · Default (UI): 30 |
Application
Citrix Workspace app (Citrix) — October 2026 templates
October 2026 templates from pl4nty/web-admx-tool.