Session reliability and automatic reconnection
Explanation
"This policy configures client behaviour in case of network failure.
To set the reconnection to , select:
Enable automatic reconnection : In case of network failure, the client automatically attempts to reconnect to a server
Enable session reliability: In case of network failure, the client attempts reconnection to an SSL/TS server.
NOTE: If both Enable Automatic reconnection and Enable session reliability is selected, the client by default selects the option Enable session reliability in case of network failure.
NOTE: If this policy is enabled and none of the options are selected, the policy is not enforced.
Transparency Level: The transparency level applied to XA/XD session during session reconnection.
Setting 0 indicates that XA and XD will be turned to black window at the session reconnection.
Setting 100 indicates that no transparency layer will be applied (frozen screen)
Troubleshooting:
Some proxy servers automatically disconnect connections that are idle for a certain length of time. This can cause client sessions to be disconnected when not in use. A server-side option ""ICA Keep-Alive"" is available to send extra data packets during periods of inactivity that can be used prevent proxies from closing connections. "
Registry
HKEY_CURRENT_USER\Software\Policies\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Network\Reconnection- Value name
- not defined in the ADMX
Enable / disable values: not defined in the ADMX (see the options below).
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_ClientAutoReconnect_1
$k = 'HKCU:\Software\Policies\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Network\Reconnection'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
# Enable automatic reconnection
# unchecked: false
Set-ItemProperty -Path $k -Name 'TransportReconnectEnabled' -Value '*' -Type String
# Transparency Level
Set-ItemProperty -Path $k -Name 'NetDisruptBrightness' -Value '80' -Type String # between 0 and 100
$k = 'HKCU:\Software\Policies\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Network\CGP'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
# Enable session reliability (has precedence if both are selected)
# unchecked: 0.0.0.0
Set-ItemProperty -Path $k -Name 'CGPAddress' -Value '' -Type StringDisable
# Disable: receiver/Policy_ClientAutoReconnect_1
# No value is written in the "Disabled" state (nothing defined in the ADMX)Revert to "Not configured"
# Revert to "Not configured": receiver/Policy_ClientAutoReconnect_1
$k = 'HKCU:\Software\Policies\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Network\Reconnection'
Remove-ItemProperty -Path $k -Name 'TransportReconnectEnabled' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'NetDisruptBrightness' -ErrorAction SilentlyContinue
$k = 'HKCU:\Software\Policies\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Network\CGP'
Remove-ItemProperty -Path $k -Name 'CGPAddress' -ErrorAction SilentlyContinueOptions (3)
| Label | Control | Registry value | REG type | Constraints / details |
|---|---|---|---|---|
| Enable automatic reconnectionPart_ClientAutoReconnect_Reconnect | Check boxboolean | TransportReconnectEnabled | REG_SZ | Default (UI): true Checked: REG_SZ = *Unchecked: REG_SZ = false |
| Enable session reliability (has precedence if both are selected)Part_ClientAutoReconnect_CGP | Check boxboolean | CGPAddressin Software\Policies\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Network\CGP | REG_SZ | Default (UI): true Checked: REG_SZ = (empty string)Unchecked: REG_SZ = 0.0.0.0 |
| Transparency LevelPart_ClientAutoReconnect_Dimming | Numeric boxdecimal | NetDisruptBrightness | REG_SZ | Min: 0 · Max: 100 · Default (UI): 80 |
Application
Citrix Workspace app (Citrix) — October 2026 templates
October 2026 templates from pl4nty/web-admx-tool.