Configuring the Group Policy Object administrative template

Citrix recommends using the Windows Group Policy Object (GPO) administrative template to configure Citrix Workspace app.

Starting with Citrix Receiver for Windows Version 4.6, the installation directory includes CitrixBase.admx and CitrixBase.adml , and, administrative template files (receiver.adm or receiver.admx\receiver.adml -depending on the Operating system) in the installation directory.

Note

The .adm file is for use with Windows XP Embedded platforms only. The .admx/.adml files are for use with Windows Vista/Windows Server 2008 and all later versions of Windows.

If Citrix Workspace app is installed with the VDA, admx/adml files are found in the Citrix Workspace app installation directory. For example: <installation directory>\Online Plugin\Configuration.

If Citrix Workspace app is installed without the VDA, the admx/adml files are typically found in the C:\Program Files\Citrix\ICA Client\Configuration directory.

See the table below for information on Citrix Workspace app templates files and their respective location.

Note

Citrix recommends that you use the GPO template files provided with latest version of Citrix Workspace app.

   
File type File location
receiver.adm <Installation Directory>\ICA Client\Configuration
receiver.admx <Installation Directory>\ICA Client\Configuration
receiver.adml <Installation Directory>\ICA Client\Configuration\[MUIculture]
CitrixBase.admx <Installation Directory>\ICA Client\Configuration
CitrixBase.adml <Installation Directory>\ICA Client\Configuration\[MUIculture]

Note

  • If the CitrixBase.admx\adml is not added to the local GPO, the Enable ICA File Signing policy might be lost.
  • When upgrading Citrix Workspace app, add the latest template files to local GPO as explained in the procedure below. While importing the latest files, previous settings are retained.

To add the receiver.adm template file to the local GPO (Windows XP Embedded Operating system only)

Citrix recommends that you use the CitrixBase.admx and CitrixBase.adml files to ensure that the options are correctly organized and displayed within the Group Policy Object Editor.

You can use .adm template files to configure both the Local and/or the domain-based GPO.

  1. Open the Citrix Workspace app Group Policy Object administrative template by running gpedit.msc.
  2. In the left pane of the Group Policy Editor, select the Administrative Templates folder.
  3. From the Action menu, choose Add/Remove Templates.
  4. Select Add and browse to the template file location <Installation Directory>\ICA Client\Configuration\receiver.adm.
  5. Select Open to add the template and then Close to return to the Group Policy Editor. Citrix Workspace app template file is available in the local GPO directory Administrative Templates > Classic Administrative Templates (ADM) > Citrix Components > Citrix Worksapce.

After the .adm template files are added to the local GPO, the following message is displayed: “The following entry in the [strings] section is too long and has been truncated: Click OK to ignore the message.

To add the receiver.admx/adml template files to the local GPO (later versions of Windows Operating System)

You can use .adm template files to configure both the Local and/or the domain-based GPO. Refer to the Microsoft MSDN article about managing ADMX files here.

After installing Citrix Workspace app, copy the template files as given in the table below:

File type Copy from Copy to
receiver.admx Installation Directory\ICA Client\Configuration\receiver.admx %systemroot%\policyDefinitions
CitrixBase.admx Installation Directory\ICA Client\Configuration\CitrixBase.admx %systemroot%\policyDefinitions
receiver.adml Installation Directory\ICA Client\Configuration[MUIculture]receiver.adml %systemroot%\policyDefinitions[MUIculture]
CitrixBase.adml Installation Directory\ICA Client\Configuration[MUIculture]\CitrixBase.adml %systemroot%\policyDefinitions[MUIculture]

Note

Citrix Workspace app template files are available on local GPO in Administrative Templates > Citrix Components > Citrix Workspace folder only if the adds the CitrixBase.admx/CitrixBase.adml to the \PolicyDefinitions folder.