Open in the explorer

Client hardware access

Type
User
GPO path
User Configuration › Policies › Administrative Templates › Citrix Components › Citrix Workspace › Remoting client devices
Supported on
All Citrix Workspace supported platforms
ADMX file
receiver.admx
Internal name
receiver/Policy_LocalPort_1

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
StateValue written
Enablednot defined in the ADMX (see the options below)
Disabled
KeyValueData
Software\Policies\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Virtual Channels\Serial PortCOMAllowedREG_SZ = false
Software\Policies\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Virtual Channels\Serial PortVirtualCOMPortEmulationREG_SZ = false
Software\Policies\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Virtual Channels\Serial PortCPMAllowedREG_SZ = false

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 String

Disable

# 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 String

Revert 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 SilentlyContinue

Options (4)

LabelControlRegistry valueREG typeConstraints / details
Maximum serial portsPart_MaxPortText boxtextMaxPortREG_SZ
Map serial portsPart_EnableSerialPortCheckboxCheck boxbooleanCOMAllowedREG_SZ
Default (UI): true
Checked: REG_SZ = true,false
Unchecked: REG_SZ = false
Allow PDA synchronizationPart_EnableVirtualSerialPortCheckboxCheck boxbooleanVirtualCOMPortEmulationREG_SZ
Default (UI): true
Checked: REG_SZ = true,false
Unchecked: REG_SZ = false
Map parallel portsPart_EnableParallelPortCheckboxCheck boxbooleanCPMAllowedin Software\Policies\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Virtual Channels\PrintingREG_SZ
Default (UI): true
Checked: REG_SZ = true,false
Unchecked: REG_SZ = false

Application

Citrix Workspace app (Citrix) — October 2026 templates

October 2026 templates from pl4nty/web-admx-tool.