Configure Environment Variables

  • To configure an Environment Variable that should be set when a session starts, go to Composition > Actions By Type > Environment Variables.
  • To configure an Environment Variable that should be set when an application starts, open the application at Applications and go to Configuration > Actions.
  • At Composition > Actions By Type > Environment Variables, the option Reset Environment Variables on refresh of workspace allows you to reset Environment Variables on a refresh of the user workspace. This ensures that connection state-dependent Environment Variables are resolved correctly.
  • You can override the global settings of this feature for specific Workspace Containers.
  • When configuring an Environment Variable, optionally enter a note in the Administrative note field. This is useful to differentiate the variables that you configured.
  • In the Value field, you can use Microsoft Windows environment variables and the functions $adinfo(<property>), $usershellfolder(<folder>), $substring, $endstring, $replacestring, $lowercase, $uppercase and $autocount.

When a session starts, the applicable Environment Variables are set in the order in which they appear in this list. If necessary, change the order to ensure the correct processing.

  • The Required connection state field specifies the required connection state that allows the setting to be applied. For example, this allows you to configure a setting that will only be applied if a computer has an online connection state.
  • Click the Access Control tab to configure the Access Control criteria of the environment variable.
  • Click the Workspace Control tab to configure to which Workspace Container(s) the environment variable applies.

Special environment variables


You can use this variable to display a custom desktop picture for a specific (group of) user(s). The variable contains the file name of the picture to be displayed on the desktop. Make sure the image is available as desktop image resources.


You can use this variable to display a custom screensaver background image for a specific (group of) user(s). The variable contains the file name of the image to be displayed as a screensaver. Make sure the image is available as screensaver image resource.


Use this variable to creates exceptions to the default drive-to-home directory.


In Windows, when an application such as Microsoft Outlook needs to open an attachment such as a Microsoft Word file, the application places the attachment in a temporary location and then starts the associated process (in this case winword.exe). The application then checks whether the process is still running. When it is no longer running, the application removes the attachment file from the temporary location again.

This does not work if an attachment is opened from an application that is managed by Workspace Control because then pwrgate.exe is always started instead of winword.exe, etc. Pwrgate.exe checks the File Types, calls the relevant application (such as Microsoft Word), and then stops. As soon as pwrgate.exe stops - which is before the application has started - the mail client removes the attachment from the temporary location. As a result, the attachment can no longer be found when the application is actually started through Workspace Control.

To prevent this, set an environment variable %pwrgatekeepalive% with the value "yes" when the application that needs to open attachments (such as Microsoft Word) is started. This will ensure that the pwrgate.exe process does not stop until the application stops - and so the attachments will not be removed from their temporary location too soon.

Related topics



User Home Directory Configuration