Group Policy Object (GPO) template
USB 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.
The archive file containing administrative template can be found in the installation directory:
%ProgramFiles%\FabulaTech\USB 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\ftusbrdpsrv.admx %WINDIR%\PolicyDefinitions\en-US\Fabulatech.adml %WINDIR%\PolicyDefinitions\en-US\ftusbrdpsrv.adml
It's recommended to use the GPO template files provided with the latest product version of USB for Remote Desktop Server.
Some GPO policies can be set in different locations, depending on their target (Computer Configuration, User Configuration), or their level of applicability (FabulaTech, Product). If a policy is configured in multiple locations, the following priority order applies (from highest to lowest):
- Computer Configuration -> Administrative Templates -> FabulaTech
- User Configuration -> Administrative Templates -> FabulaTech
- Computer Configuration -> Administrative Templates -> FabulaTech -> USB for Remote Desktop (Server)
- User Configuration -> Administrative Templates -> FabulaTech -> USB for Remote Desktop (Server)
- Product settings (GUI, registry, etc.)
Policies defined at a higher level override those set at lower levels.
The GPO template can be used to configure the following settings:
| Setting | Target | Level | Description |
|---|---|---|---|
| Licensing | Computer | Product |
This policy setting is used for licensing management. The following licensing modes are used:
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. |
| Log file rotation | Computer | Product |
This policy setting controls advanced log file rotation behavior. The product may create multiple logs for each user, depending on factors such as Session ID, Process ID (PID), and FabulaTech product module. Each log is stored on disk as a set of log file parts, which are created as the log is rotated. When the active log file part reaches the configured size limit, it is rotated: the current file part is renamed, and a new empty file part is created for the same log. If any of the configured limits are exceeded, the oldest log file parts are automatically removed according to the configured rules.
If this policy is disabled or not configured, log file rotation behavior is controlled by the application’s internal log rotation settings. |
| Log level | Computer | Product |
If this policy is disabled or not configured, the log level is controlled by the application’s internal logging settings. |
| Device connection policies | User | Product |
This policy setting allows you to configure USB device connection rights. For example, you can deny access to mass storage devices for all users except administrators, or allow access to a specific model of a signature pad for a specific user and automatically connect that device when the user logs on. Each policy consists of two main components: Device Group, which identifies the USB device or devices Policy Action, which defines how the matching device is handled 1. Device GroupA Device Group is a set of properties used to identify one or more USB devices. A Device Group may represent a single USB device or a group of similar devices. The following USB device properties can be used:
To identify a group of USB devices, only a subset of these properties may be specified. Device Group Matching and PriorityIf multiple Device Groups match a USB device, the group with the highest priority is selected. A Device Group has a higher priority when it specifies more identifying properties. Each property has the following priority weight: Property (Priority)
The total priority of a Device Group is calculated as the sum of the weights of all specified properties. Example:If one Device Group specifies VID + PID + Serial number and another specifies Class + Subclass, the first group has a higher priority. Important:If a USB device is a composite device, multiple Device Groups with the same priority may match the device (depending on the number of USB interfaces). In this case, the Policy Action with the highest priority is applied. 2. Policy ActionsA Policy Action defines how a matching USB device is handled for a specific user. The following actions are supported:
If a USB device does not match any Device Group, it is allowed to connect (Allow action). Policy Action Matching and PriorityWhen a USB device matches a Device Group, the system selects the appropriate Policy Action for the logged-on user. If multiple Policy Actions apply (for example, one for a user group and one for a specific user), the action with the highest priority is selected. Policy Action (Priority)
If a USB device is a composite device and multiple Device Groups with the same priority match it, the Policy Action with the highest priority is applied. Device Policies FormatThe Device Policies setting is a multi-string value that represents a list of device policies. Each entry defines the action to be applied to a specific Device Group. Syntax"name" action [hwid vid[:pid]][class cls[:sub[:proto]]][serial "serial"] Parameters
allow | auto | force | deny | excludeDevice Policy Examples It's a good practice to deny (prohibit to connect) or exclude (hide and prohibit to connect) all USB device, and allow only specific devices or device groups. Example 1 - allow only specific signature pad model and any smart card USB devices "Deny all" deny "Sigpad" allow hwid 2133:000F "Smartcards" allow class 0B Example 2 - auto-connect SpeechMike USB dictation microphone the device at log-on, prevent disconnection "Exclude all" exclude "Philips SpeechMike" force hwid 0911:0C1C Example 3 - automatically connect a specific USB device instance when multiple devices of the same model are present. The target device is uniquely identified by its USB device serial number. "Deny all" deny "Gemalto eToken" allow hwid 08E6:34CF serial "66EABC8761C2" If this policy setting is disabled or not configured, locally configured device policies are used. |
| Turn off "Check for updates" | Computer | FabulaTech, Product |
This policy setting determines whether the application is allowed to check for updates and notify the logged-on user.
Enabled:
Disabled:
Not Configured: Note: If this policy setting is applied at the FabulaTech level, it overrides the same policy setting applied at the product level for all installed FabulaTech products. |
| Audio device isolation mode | Computer | FabulaTech |
This setting is common for multiple FabulaTech products, including USB for Remote Desktop, Sound for Remote Desktop, and Webcam for Remote Desktop. This policy setting defines how redirected audio devices are isolated across user sessions in a multi-user environment. This setting is relevant when multiple users are logged on to the same server simultaneously and multiple audio devices are present. FabulaTech isolates audio devices within user sessions so that only the owning user can access the redirected device. To provide isolation, the program relies on a dedicated FabulaTech isolation driver. If the isolation driver is disabled or uninstalled (for example, by an administrator or security software), audio isolation may be affected. As a result, an audio device may become accessible from another user session. Important: The audio device isolation mode is determined when a user session starts. If this policy setting is changed, existing user sessions are not affected. Users must sign out and sign in again for the new isolation mode to take effect. To address such scenarios, the following isolation modes are available:
If this policy setting is Disabled or Not Configured The audio isolation mode is controlled by the local settings of the corresponding FabulaTech device redirection software (Sound for Remote Desktop, Webcam for Remote Desktop, or USB for Remote Desktop). |