Product Documentation

Advanced settings

These settings modify how and when the agent processes actions.


Configuration

These options control basic agent behavior.

Main Configuration

Agent Actions. These settings determine whether or not the agent processes actions configured in the Actions tab. These settings apply at login, automatic refresh, or manual (user or administrator triggered) refresh.

Process Applications. When selected, the agent processes application actions.

Process Printers. When selected, the agent processes printer actions.

Process Network Drives. When selected, the agent processes network drives actions.

Process Virtual Drives. When selected, the agent processes virtual drive actions. (Virtual drives are Windows virtual drives or MS-DOS device names which map a local file path to a drive letter.)

Process Registry Values. When selected, the agent processes registry entry actions.

Process Environment Variables. When selected, the agent processes environment variable actions.

Process Ports. When selected, the agent processes port actions.

Process Ini Files Operations. When selected, the agent processes .ini file actions.

Process External Tasks. When selected, the agent processes external task actions.

Process File System Operations. When selected, the agent processes file system operation actions.

Process File Associations. When selected, the agent processes file association actions.

Process User DSNs. When selected, the agent processes user DSN actions.

Agent Service Actions. These settings determine when the agent service processes its instructions.

Launch Agent at Logon. Determines whether or not the agent runs at logon.

Launch Agent at Reconnect. Determines whether or not the agent runs when reconnecting to a published desktop.

Launch Agent for Admins. Determines whether agent runs when a user is an administrator.

Agent Type. Determines whether the user is presented with a user interface (UI) or not (CMD) when interacting with the Agent.

Enable (Virtual) Desktop Compatibility. This setting is necessary for the agent to be launched when the user is logged in to session 1. If you have any users on physical desktops or VDI, select this option.

Execute only CMD Agent in Published Applications. If enabled, the agent will launch in command line mode (CMD) when launching a published application, rather than in UI mode. CMD mode displays a command prompt instead of an agent splash screen.

Cleanup Actions

These settings determine whether or not the agent performs an environment cleanup on refresh.

Shortcut Deletion at Startup. The agent deletes all shortcuts of the selected type whenever it refreshes.

Delete Network Drives at Startup. If enabled, the agent deletes all network drives whenever it refreshes.

Delete Network Printers at Startup. If enabled, the agent deletes all network printers whenever it refreshes.

Preserve Auto-created Printers. If enabled, the agent does not delete auto-created printers.

Preserve Specific Printers. If enabled, the agent does not delete any of the printers in this list.

Agent Options

These options control the agent settings.

Enable Agent Logging. Enables the agent log file.

Log File. The log file location. By default, this is the profile root of the logged-in user.

Debug Mode. This enables verbose logging for the agent.

Enable Offline Mode. If this is disabled, the agent does not fall back on its cache if it cannot connect to the infrastructure service. Note In order for Offline Mode to work, SQL Server Compact Edition 3.5 SP2 must be installed in the user environment and on the Workspace Environment Management infrastructure server.

Use Cache Even if Online. If enabled, the agent always reads its settings and actions from its cache (which is built whenever the agent service cycles).

Refresh Settings. If enabled, the agent triggers a Windows refresh when an agent refresh occurs.

Refresh on Environmental Setting Change. If enabled, the agent triggers a Windows refresh when an environmental setting is modified.

Asynchronous Printer Processing. If enabled, the agent processes printers asynchronously from other actions.

Asynchronous Network Drive Processing. If enabled, the agent processes network drives asynchronously from other actions.

Initial Environment/Desktop Cleanup. If enabled, the agent cleans up the environment/desktop at first login only.

Check Application Existence. If enabled, the agent checks that an application is available to the user/group before creating a shortcut to that application.

Expand App Variables. If enabled, variables are expanded by default (see Environment variables for normal behavior when the agent encounters a variable).

Enable Cross-Domain User Group Search. If enabled, the agent queries user groups in all Active Directory domains. Note: This is an extremely time-intensive process which should only be selected if necessary.

Broker Service Timeout. The timeout value after which the agent switches to its own cache, when it fails to connect to the infrastructure service. The default value is 2000 milliseconds.

Directory Services Timeout. The timeout value for directory services on the Agent Host machine, after which the agent uses its own internal cache of user group associations. The default value is 2000 milliseconds.

Network Resources Timeout. The timeout value for resolving network resources (network drives or file/folder resources located on the network), after which the agent considers the action has failed. The default value is 500 milliseconds.

Agent Max Degree of Parallelism. The maximum number of threads the agent can use. Default value is 0 (as many threads as physically allowed by the processor), 1 is single-threaded, 2 is dual-threaded, etc. In most cases this value does not need changing.

Advanced Options

Enforce Execution of Agent Actions. If these settings are enabled, the Agent Host will always refresh those actions, even if no changes have been made.

Revert Unassigned Actions. If these settings are enabled, the Agent Host will delete any unassigned actions when it next refreshes.

Automatic Refresh. If enabled, the Agent Host will refresh automatically. By default, the refresh delay is 30 minutes.

Reconnection Actions

Action Processing on Reconnection. These settings control what actions the Agent Host processes upon reconnection to the user environment.

Advanced Processing

Filter Processing Enforcement. If enabled, these options will force the Agent Host to re-process filters at every refresh.

Service Options

These settings configure the Agent Host service.

Agent Cache Refresh Delay. This setting controls how long the Agent Host service will wait to refresh its cache.

SQL Settings Refresh Delay. This setting controls how long the Agent Host service will wait to refresh its SQL connection settings.

Agent Extra Launch Delay. This setting controls how long the Agent Host service will wait to launch the Agent Host executable.

Enable Debug Mode. This enables verbose logging for all Agent Hosts connecting to this site.

Bypass ie4uinit Check. By default, the Agent Host service will wait for ie4uinit to run before launching the Agent Host executable. This setting forces the Agent Host service to not wait for ie4uinit.

Agent Launch Exclusions. If enabled, the Citrix Workspace Environment Management Agent Host will not be launched for any user belonging to the specified user groups.

Console Settings

Forbidden Drives. Any drive letter added to this list is excluded from the drive letter selection when assigning a drive resource.

StoreFront

Use this tab to add StoreFront stores to the Workspace Environment Management configuration. You can then assign an Applications Action tab to define shortcuts to applications from in that those stores. For Transformer kiosk-enabled machines, assigned StoreFront Applications Actions appear in the Applications tab in the Transformer kiosk. For more information on StoreFront stores, see StoreFront documentation.

To add a store

  1. Click Add.
  2. Enter details in the Add Store dialog, then click OK. The store is saved in your configuration set.

Store URL. The URL of the store on which you want to access resources using Workspace Environment Management. The URL must be specified in the form http[s]://hostname[:port], where hostname is the fully qualified domain name of the store and port is the port used for communication with the store if the default port for the protocol is not available.

Description. Optional text describing the store.

To edit a store*

Select a store in the list and click Edit to change the store URL or description.

To remove a store

Select a store in the list and click Remove to remove a store from your configuration set.

To apply changes

Click Apply to apply store settings immediately to your agents.


UI Agent Personalization

These options allow you to personalize the look and feel of the Citrix Workspace Environment Management session agent in UI mode, as well as help desk and self-service facilities.

Note:

These options apply to the session agent in UI mode only. They do not apply to the session agent in CMD mode.

UI Agent Options

These settings let you customize the appearance of the session agent (in UI mode only) in the user’s environment.

Custom Background Image Path. If entered, will display a custom image when the session agent launches/refreshes, rather than the Citrix Workspace Environment Management logo. The image used must be accessible from the user environment. It is recommended you use a 400*200px .bmp file.

Loading Circle Color. Allows you to modify the color of the loading circle to fit your custom background.

Text Label Color. Allows you to modify the color of the loading text to fit your custom background.

UI Agent Skin. Allows you to select a preconfigured skin to use for dialogs and self service forms (printers/applications). Note: This does not change the splash screen.

Hide Agent Splashscreen. If enabled, hides the splash screen when the session agent is loading/refreshing. This takes effect after the session agent has refreshed while the setting is enabled.

Hide Agent Icon in Published Applications. If enabled, published applications do not show the Citrix Workspace Environment Management session agent.

Hide Agent Splashscreen in Published Applications. If enabled, hides the session agent splash screen for published apps running through it.

Only Admins Can Close Agent. If enabled, only administrators can shut down the Citrix Workspace Environment Management session agent.

Allow Users to Manage Printers. If enabled, users can access the Citrix Workspace Environment Management session agent Manage Printers menu to assign a default printer and modify print preferences.

Allow Users to Manage Applications. If enabled, users can access the Citrix Workspace Environment Management session agent Manage Applications menu to manage where their application shortcuts are created. Shortcuts created in self-healing mode cannot be deleted using this menu.

Prevent Admins to Close Agent. If enabled, administrators cannot shut down the Citrix Workspace Environment Management session agent.

Enable Applications Shortcuts. If enabled, users can run applications from the Manage Applications menu.

Disable Administrative Refresh Feedback. When Administrators force a session agent to refresh from the Administration Console, this options prevents a notification tooltip appearing in the user environment.

Helpdesk Options

These options control the Agent Host’s help desk functionalities.

Help Link Action. This field controls what happens when the user clicks on the Help command in the Citrix Workspace Environment Management Agent Host.

Custom Link Action. This field controls what happens when the user clicks on the Support command in the Citrix Workspace Environment Management Agent Host.

Enable Screen Capture. If enabled, users are given the option to open a screen capture utility. This allows the user to screenshot any errors in their environment, which they can then send to your support staff.

Enable Send to Support Option. If enabled, the user is able to send screenshots and log files directly to the nominated support email address, with the specified template. This requires a working, configured email client.

Custom Subject. If enabled, the support email generated by the Citrix Workspace Environment Management Agent Host screen capture utility is sent with the specified subject.

Email Template. This field allows you to specify a template for the support email generated by the Citrix Workspace Environment Management Agent Host screen capture utility. Note you must configure the email template to include useful information.

See Dynamic tokens for a list of hash-tags which can be used in the email template. Note Users are only presented with the option to enter a comment if the ##UserScreenCaptureComment## hash-tag is included in the email template.

Use SMTP to Send Email. If enabled, this will send the support email using SMTP instead of MAPI.

Test SMTP. Tests your SMTP settings as entered above to verify that they are correct.

Power Saving

Shut Down At Specified Time. If enabled, the Agent Host will automatically shut off the environment it is running in at the specified local time.

Shut Down When Idle. If enabled, the Agent Host will automatically shut off the environment it is running in after running idle (no user input) for the specified length of time.

Advanced settings