- UI Agent Personalization
These options control basic Agent behavior.
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.
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.
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.
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.
Action Processing on Reconnection. These settings control what actions the Agent Host processes upon reconnection to the user environment.
Filter Processing Enforcement. If enabled, these options will force the Agent Host to re-process filters at every refresh.
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.
Forbidden Drives. Any drive letter added to this list is excluded from the drive letter selection when assigning a drive resource.
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
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.