Group Policy Object (GPO) template

Serial Port for Remote Desktop Server includes *.admx and *.adml administrative template files. These template files allow to configure the product via Local GPO and/or Domain-Based GPO. Please refer to Microsoft MSDN article on managing ADMX files.

GPO Editor

The archive file containing administrative template can be found in the installation directory:

%ProgramFiles%\FabulaTech\Serial Port for Remote Desktop (Server)\policies.zip

Additionally, the administrative template files are deployed to a local GPO during product installation and can be found here:

%WINDIR%\PolicyDefinitions\Fabulatech.admx
%WINDIR%\PolicyDefinitions\ftsprrdp.admx
%WINDIR%\PolicyDefinitions\en-US\Fabulatech.adml
%WINDIR%\PolicyDefinitions\en-US\ftsprrdp.adml

it's recommended to use the GPO template files provided with the latest version of Serial Port for Remote Desktop Server.

The GPO template can be used to configure the following settings:

Setting Description
Local settings priority

If this policy setting is enabled, the local program settings have priority over policy settings.

If this policy setting is disabled or not configured, policy settings have priority over local program settings.

Within the scope of each type of settings, the settings set for the computer always have priority over settings set for the user. If this policy setting is set for the computer, it has priority over policy setting set for the user.

Disable functionality

If this policy setting is enabled, the connection with the workstation side is not established, the ports are not redirected.

If this policy setting is disabled, the Serial COM works in usual mode.

If this policy setting is not configured, the disabling functionality is determined by local program settings.

Connect all ports automatically

If this policy setting is enabled, all client COM ports will be automatically connected (even if no individual GPO is configured). If there are individual GPO settings configured for some of the ports, the individual port GPO settings are used.

If this policy setting is disabled or not configured, the auto-connect functionality is determined by individual port GPO or local program settings.

COM Port Isolation Mode

If Full Isolation mode is chosen, virtual serial ports are visible and accessible within user sessions only. In this mode COM port names can have the same names in different user sessions. Important: system services (like spoolsrv.exe) are not able to access isolated serial ports in such case.

If Strict Isolation mode is chosen, virtual serial ports are visible and accessible within user sessions and only withing the processes run under the owner of the session. This means that the processes started using "Run as Administrator", or the processes started using PsExec utility will not be able to see and access the redirected serial ports.

If Isolation Disabled mode is chosen, virtual serial ports are visible globally. Any port can be accessed from any session. Limitation: port names must be unique for every user (so the ports cannot have the same names in different user sessions). Important: system services (like spoolsrv.exe) can access any serial ports.

If this policy setting is not configured, Serial Redirection operates in the default mode:

  • If Terminal Services is installed, "Full Isolation" mode is applied.
  • If Terminal Services is not installed, "Isolation Disabled" mode is applied.
Lock configuration

If this policy setting is enabled, the user interface containing the program settings is locked and the user can't change settings in the tray menu.

If this policy setting is disabled, the user interface containing the program settings is accessible for users.

If this policy setting is not configured, the blocking of the configuration is determined by local program settings.

If this policy setting is configured for the computer, it has priority over policy setting configured for the user.

Bandwidth limit

If this policy setting is enabled, the data transfer speed between the server and all workstations is limited by the specified kilobytes per second.The value "0" disables speed limitation

If this policy setting is disabled, the speed limitation is disabled.

If this policy setting is not configured, the speed limitation is determined by local program settings.

Allow/Deny port filters

If this policy is enabled, the Allow and Deny filers are used in order to decide if every specific COM port detected on the Workstation side is allowed for redirection or not.

In case if some port is not allowed for redirection, the Server side will threat it as if the port does not even exist on the Workstation side.

The lists use USB device properties of the COM port's rules.

Example:

USB:067B:2303:*
USBPATH:1-4
WINDEVID:*ACPI*
PORTNAME:COM3
PORTNAME:COM5

Syntax:

USB:[*|VID[:*|:PID[:*|:REV]]]
VID – Hex numeric VID (Vendor ID) value from device HardwareID
PID – Hex numeric PID (Product ID) value from device HardwareID
REV – Hex numeric REV (Revision) value from device HardwareID
when VID, PID, REV equal to "*" – it means any value.
USBPATH:[N1[-N2[...[-N8]]]]
Nx – Numeric value (1-127 range) that identifies the USB port.
WINDEVID:[HwId|*|?]
HwId – full or partial value of device HardwareID (wildcards characters * and ? are supported). Case insensitive.
PORTNAME:[PortName|*|?]
PortName – full or partial value of serial port name (wildcards characters * and ? are supported). Case insensitive.

Examples:

USB:067B:2303:400 – matches the USB device with the specified VID, PID and Revision. USB\VID_067B&PID_2303&REV_0400

USB:067B:2303:* – matches any USB device with the specified VID and PID and any Revision. USB\VID_067B&PID_2303

USB:067B:* – matches any USB device with the specified VID and any PID and any Revision. USB\VID_067B

USB:* – matches any USB device

USBPATH:1-2-1 – matches the identificator of the USB port where the device is plugged physically

WINDEVID:* – matches any HardwareID string

WINDEVID:*ACPI* – matches a HardwareID string containing ACPI substring

PORTNAME:COM3 – matches only "COM3" serial port

PORTNAME:*M3 – matches serial ports with the names ending with "M3". E.g. COM3, VCOM3.

PORTNAME:*M3* – matches serial ports with names containing "M3" substring. E.g. COM3, COM33, VCOM333.

PORTNAME:/dev/ttys* – matches all "/dev/ttys" devices. E.g. /dev/ttyS0, /dev/ttyS5.

Remarks:
The Allow list has higher priority. So if the device is matched by the Deny list, the device is excluded from the redirection. But if at the same time the device is matched by the Allow list, the device is allowed for the redirection.

PortSettings

This policy setting is used for configuring certain port parameters that are used for their redirection:

Source port number
Number of the COM port redirected from the workstation side (e.g. 2 means COM2).
Source port device

By default, the name of Serial port device redirected from the workstation side. Also, special syntax is supported for complex serial device matching.

Note: This parameter has higher priority than Source port number.

Source port is usually identified by the device name (e.g., "COM5" for Windows, or "/dev/ttySerial0" for Linux). Anyway, special matching syntax is supported in order to identify the source serial device by USB device properties, USB Port identifier and so on. Refer to Allow/deny filters section for more details.

Destination virtual port number
virtual COM port number, created on the server side and corresponding to the COM port on the workstation side.
Autoconnect
If this flag is set, the port is automatically redirected to the server side when it plugged on the workstation side.
IgnoreDsr
If this flag is set, the DSR signal is ignored.
Pause before close port
Troubleshooting setting. Time (in ms) to wait after virtual COM port was closed by user. Required for some USB-COM adapters.
Use pause before send data
If this flag is set, pause before send data after port opening will use. See value "Pause before send data"
Pause before send data
Troubleshooting setting. Time (in ms) to wait before virtual COM port will transfer data to physycal side. Required for some specific serial devices (Olivetti card reader).
Disable overlapped mode
Troubleshooting setting. Disables Overlapped Mode when communicating with hardware COM ports. This allows to overcome specific issues of GlobalSat BU353 GPS adapter (and some other Prolific USB-COM adapters). The setting is stored in the Serial2USBModeChangeEnabled registry key.
Disable errors in wait mask
Troubleshooting setting. Disables "error" value in serial COM mask. See "http://msdn.microsoft.com/en-us/library/windows/desktop/aa363479(v=vs.85).aspx". Required for some software.
Handle bluetooth device disappearance
Troubleshooting setting. It handles the situations when Bluetooth COM-ports disappear suddenly on the Client side (because the Bluetooth device gets out of range) and then appear again. The setting is stored in the HandleBtDisappear registry key.
USB to COM troubleshooting
Troubleshooting setting. Fixes some specific issues of USB-COM adapters. The setting is stored in the UsbToComTroubleShooting registry key.
Use network latency compensation
Troubleshooting setting. Use compensation capability to avoid influence of network delays.
Compensation level
Troubleshooting setting. Using spinedit, select network latency compensation level. Find out the minimal level at which your communications application works stable with a remote serial device.
Use fixed baud rate
If this flag is set, the value specified in "Bits per second" is used instead of the baudrate set by serial communications application.
Bits per second
Fixed baudrate value in bits per second (applied, if "Use fixed baud rate" is set).
Use fixed line control
– If this flag is set, the values specified in "Data bits", "Parity" and "Stop bits" are used instead of the values set by serial communications application.
Data bits
Fixed Databits value (applied, if "Use fixed line control" is set) [values from 5 to 8].
Parity
Fixed Parity value (applied, if "Use fixed line control" is set).
Stop bits
Fixed Stop bits value (applied, if "Use fixed line control" is set).
Use fixed flow control
– If this flag is set, the value specified in "Flow control" is used instead of the value set by serial communications application.
Flow control
Fixed Stop bits value (applied, if "Use fixed flow control" is set).

If this policy setting is enabled, its parameters are used during port redirection.

If this policy setting is disabled or not configured, parameters specified in local program settings are used for port redirection.

If this policy setting is configured for the computer, it has priority over policy setting configured for the user.

Disable Update Subscription Expiration Notification

This policy setting controls whether update subscription expiration notifications are displayed.

If Enabled, the update subscription expiration notifications will not appear.
If Disabled, the update subscription expiration notifications will appear.
If Not Configured, the notification mode is determined by the corresponding user policy setting or the user interface setting.

This policy setting overrides any user-configured preferences, meaning users cannot change the update subscription notification mode through the user interface.

Licensing

This policy setting is used for licensing management. The following licensing modes are used:

License Key
use the specified license key for each product server;
License Server
use a license server for centralized management of licensing;

For "License Key" type of licensing you must specify a string of the key in the corresponding field.

For "License Server" type of licensing you must specify a license server name in the name_or_ip:port format, where the port is an optional parameter.

If this policy setting is enabled, the licensing mode will be overridden by this policy setting. It means using GPO License key instead key that determined via the settings interface.

If this policy setting is disabled or not configured, the licensing mode is determined via the settings interface.