Configure NetScaler LAN proxy using DLL
Explanation
Citrix Workspace app supports session launches using the NetScaler LAN proxy.
If both static proxy and dynamic proxies are configured, the dynamic proxy configuration takes precedence.
You can configure Dynamic proxy: Select the Configure NetScaler LAN proxy using DLL policy. Select Enabled and then provide the full path to the DLL file. For example, C:\Workspace\Proxy\ProxyChooser.dll.
Click Apply and OK.
Registry
HKEY_LOCAL_MACHINE\Software\Policies\Citrix\ICA Client\Engine\Network Routing\Proxy\NetScaler LAN Proxy- Value name
DynamicProxyEnabled
| 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/POL_CONFIGURE_LAN_PROXY_DLL
$k = 'HKLM:\Software\Policies\Citrix\ICA Client\Engine\Network Routing\Proxy\NetScaler LAN Proxy'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
Set-ItemProperty -Path $k -Name 'DynamicProxyEnabled' -Value 1 -Type DWord
Set-ItemProperty -Path $k -Name 'ProxyChooserDLL' -Value '' -Type String
# Proxy chooser DLL path
Set-ItemProperty -Path $k -Name 'ProxyChooserDLL' -Value '<value>' -Type StringDisable
# Disable: receiver/POL_CONFIGURE_LAN_PROXY_DLL
$k = 'HKLM:\Software\Policies\Citrix\ICA Client\Engine\Network Routing\Proxy\NetScaler LAN Proxy'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
Set-ItemProperty -Path $k -Name 'DynamicProxyEnabled' -Value 0 -Type DWord
Remove-ItemProperty -Path $k -Name 'ProxyChooserDLL' -ErrorAction SilentlyContinueRevert to "Not configured"
# Revert to "Not configured": receiver/POL_CONFIGURE_LAN_PROXY_DLL
$k = 'HKLM:\Software\Policies\Citrix\ICA Client\Engine\Network Routing\Proxy\NetScaler LAN Proxy'
Remove-ItemProperty -Path $k -Name 'DynamicProxyEnabled' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'ProxyChooserDLL' -ErrorAction SilentlyContinueOptions (1)
| Label | Control | Registry value | REG type | Constraints / details |
|---|---|---|---|---|
| Proxy chooser DLL pathTXT_ProxyChooserDLL | Text boxtext | ProxyChooserDLL | REG_SZ | Required · Max length: 260 |
Application
Citrix Workspace app (Citrix) — October 2026 templates
October 2026 templates from pl4nty/web-admx-tool.