Client hardware access
Explanation
Use this policy to specify maximum number of serial ports supported by the client platform.
Also, use this policy to enable and restrict the remote application or desktop's access to the client’s serial, USB, and parallel ports. This allows the server to use locally attached hardware.
Troubleshooting:
Remote PDA synchronization uses "virtual COM ports". These are serial port connections that are routed through USB connections. It is necessary to enable serial port access to use PDA synchronization for this reason.
Registry
HKEY_CURRENT_USER\Software\Policies\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Virtual Channels\Serial Port- Value name
- not defined in the ADMX
| State | Value written | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Enabled | not defined in the ADMX (see the options below) | ||||||||||||
| Disabled |
|
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_LocalPort_1
$k = 'HKCU:\Software\Policies\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Virtual Channels\Serial Port'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
# Maximum serial ports
Set-ItemProperty -Path $k -Name 'MaxPort' -Value '<value>' -Type String
# Map serial ports
# unchecked: false
Set-ItemProperty -Path $k -Name 'COMAllowed' -Value 'true,false' -Type String
# Allow PDA synchronization
# unchecked: false
Set-ItemProperty -Path $k -Name 'VirtualCOMPortEmulation' -Value 'true,false' -Type String
$k = 'HKCU:\Software\Policies\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Virtual Channels\Printing'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
# Map parallel ports
# unchecked: false
Set-ItemProperty -Path $k -Name 'CPMAllowed' -Value 'true,false' -Type StringDisable
# Disable: receiver/Policy_LocalPort_1
$k = 'HKCU:\Software\Policies\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Virtual Channels\Serial Port'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
Set-ItemProperty -Path $k -Name 'COMAllowed' -Value 'false' -Type String
Set-ItemProperty -Path $k -Name 'VirtualCOMPortEmulation' -Value 'false' -Type String
Set-ItemProperty -Path $k -Name 'CPMAllowed' -Value 'false' -Type StringRevert to "Not configured"
# Revert to "Not configured": receiver/Policy_LocalPort_1
$k = 'HKCU:\Software\Policies\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Virtual Channels\Serial Port'
Remove-ItemProperty -Path $k -Name 'COMAllowed' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'VirtualCOMPortEmulation' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'CPMAllowed' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'MaxPort' -ErrorAction SilentlyContinue
$k = 'HKCU:\Software\Policies\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Virtual Channels\Printing'
Remove-ItemProperty -Path $k -Name 'CPMAllowed' -ErrorAction SilentlyContinueOptions (4)
| Label | Control | Registry value | REG type | Constraints / details |
|---|---|---|---|---|
| Maximum serial portsPart_MaxPort | Text boxtext | MaxPort | REG_SZ | |
| Map serial portsPart_EnableSerialPortCheckbox | Check boxboolean | COMAllowed | REG_SZ | Default (UI): true Checked: REG_SZ = true,falseUnchecked: REG_SZ = false |
| Allow PDA synchronizationPart_EnableVirtualSerialPortCheckbox | Check boxboolean | VirtualCOMPortEmulation | REG_SZ | Default (UI): true Checked: REG_SZ = true,falseUnchecked: REG_SZ = false |
| Map parallel portsPart_EnableParallelPortCheckbox | Check boxboolean | CPMAllowedin Software\Policies\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Virtual Channels\Printing | REG_SZ | Default (UI): true Checked: REG_SZ = true,falseUnchecked: REG_SZ = false |
Application
Citrix Workspace app (Citrix) — October 2026 templates
October 2026 templates from pl4nty/web-admx-tool.