Workspace Environment Management

Registry Entries

Controls the creation of registry entries.

Tip:

You can use dynamic tokens to extend Workspace Environment Management actions to make them more powerful.

Registry value list

A list of your existing registry entries. You can use Find to filter the list by name or ID against a text string.

To add a registry entry

  1. Use the context menu Add command.
  2. Enter details in the New Registry Value dialog tabs, then click OK.

Fields and controls

Name. The display name of the registry entry, as it appears in the registry entry list.

Description. This field is only shown in the edition/creation wizard and allows you to specify additional information about the resource.

Registry Value State. Toggles whether the registry entry is enabled or disabled. When disabled, it will not be processed by the agent even if assigned to a user.

Target Path. The registry location in which the registry entry will be created. Workspace Environment Management can only create Current User registry entries, so you do not need to preface your value with %ComputerName%\HKEY_CURRENT_USER – this is done automatically.

Target Name. The name of your registry value as it appears in the registry (for example, NoNtSecurity).

Target Type. The type of registry entry that will be created.

Target Value. The value of the registry entry once created (for example, 0 or C:\Program Files)

Run Once. By default, Workspace Environment Management creates registry entries every time the agent refreshes. Select this check box to make Workspace Environment Management create the registry entry only once - on the first refresh - rather than on every refresh. This speeds up the agent refresh process, especially if you have many registry entries assigned to your users.

Action Type. Describes what type of action this resource is.

Import registry files

You can convert your registry file into registry entries for assignment. This feature has the following limitations:

  • It supports only registry values under HKEY_CURRENT_USER. With the registry entries feature, you can assign only registry settings under HKEY_CURRENT_USER.

  • It does not support registry values of the REG_BINARY and REG_MULTI_SZ types.

To avoid the limitations, we recommend that you import your registry files to WEM by using the Import Registry File option in Group Policy Settings. For more information, see Import Group Policy settings from registry files.

To import a registry file, do the following:

  1. Use Upload to upload the registry file you want to import. The file appears in the default folder in Citrix Cloud.

  2. Go to Legacy Console > Actions > Registry Entries.

  3. In the ribbon, click Import Registry File.

  4. In the Import from Registry File window, select the desired registry file from the list. You can also start typing the file name and then click Find to locate it.

  5. Click Scan to start scanning the registry file. After the scan completes successfully, a list of registry settings appears.

  6. Select the registry settings that you want to import and then click Import Selected to start the import process.

  7. Click OK to exit.

Fields and controls

Registry File Name. Populates automatically after you navigate to a .reg file and click Open. The .reg file contains registry settings you want to import into WEM. The .reg file must be generated from a clean environment to which only the registry settings you want to import are applied.

Scan. Scans the .reg file and then displays a list of registry settings that the file contains.

Registry Values List. Lists all registry values that the .reg file you want to import contains.

Enable Imported Items. If disabled, newly imported registry keys are disabled by default.

Prefix Imported Item Names. If selected, adds a prefix to the name of all registry items imported through this wizard (for example, “XP ONLY” or “finance”). Doing so makes it easier to identify and organize your registry entries.

Note:

The wizard cannot import registry entries with the same names. If your .reg file contains more than one registry entry that has the same name (as displayed in the Registry Values List), select one of those entries for import. If you want to import the others, rename them.

Registry Entries

In this article