Workspace Environment Management

Administration

Lets you view user and agent statistics and administrative activities.


User statistics

Displays user statistics about your Workspace Environment Management (WEM) deployment. Each time users log on to their agent machine, relevant information is collected and then appears here as a table record.

This page includes the following information:

  • User summary. Displays a count of all users who have logged on to their agent machine, for all configuration sets.

  • User history. Displays connection information for all users associated with all configuration sets, including the last connection time (in Coordinated Universal Time, UTC), the name of the machine from which they last connected, and the session agent type (UI or CMD) and version.

Tip:

You can use Filter to filter the list. For example, display a count of all users for a specific configuration set and a count of users during the specified date range.

You can perform the following operations:

  • Refresh. Updates the list of user statistics.

  • Clear expired records. Lets you delete expired records from the WEM service database. If a user’s last logon time dates back more than 24 hours, the corresponding record expires. Unavailable when you do not have any expired records. Note: This option is not available for records whose User ID is Local system.

  • Delete record. Deletes the record from the WEM service database. Available when you select only one agent and its corresponding record has expired. Note: This option is not available for records whose User ID is Local system, Network service, or NT Authority (Local service).

  • Export. Lets you export the data in each record in CSV or JSON format, which opens in programs such as Microsoft Excel. To do that, perform the following steps:

    1. Click Export. The export wizard appears.
    2. Select the export format. Available options: CSV and JSON.
    3. Optionally, select Save a copy of the export to your local machine. The export will be saved to the default download location of your browser.
    4. Click Export to start the export process.

    Important:

    • You can export up to 50,000 records. When the number of records to export exceeds the limit, only the top 50,000 will be exported. We recommend that you use filters to reduce the number of records to 50,000 or fewer.
    • While an export is in progress, you cannot perform another export.
    • If an export does not complete within 30 minutes, you will no longer receive notifications about it. Go to Files to view the export result later.
    • When exporting user statistics, the export will be saved to the cloud storage. The cloud storage has a storage limit. When you reach the limit, you cannot proceed with the export. In that case, go to Files and delete unnecessary files to free up space. See Files.

WEM agents

This page lets you view agent information and perform administrative tasks such as refreshing the cache, resetting settings, and retrieving agent information.

You can view the following statistics about the agents in your WEM deployment.

  • A count of total agents users have logged on to, for all configuration sets.

    Tip:

    If you specify a configuration set in your filter criteria, a count of total registered agents for that configuration set appears, along with the count of agents registered in the last 24 hours and in the last 30 days.

  • Connection information for all agents registered with the configuration sets, including the last connection time, the name of the machine from which they last connected, and the agent version.

  • The Synchronization state column provides information about the result of the last sync of the agent cache with the WEM service.

    • Successful (check mark icon). Indicates that the last sync was successful, with the sync result reported to the administration console.
    • Unknown (exclamation mark icon). Indicates that sync is in progress, has not started yet, or the result is not reported to the administration console.
    • Failed (error icon). Indicates that the last sync failed.
  • The Recently connected column provides the following information:

    • Online (check mark icon). Indicates that the agent is online. The agent has uploaded statistics to the WEM service within a certain interval.
    • A blank column field indicates that the agent is offline.
  • The Profile Management Health Status column provides information about the health status of Profile Management in your environment.

    Profile Management health status performs automated status checks on your agent hosts to determine whether Profile Management is configured optimally. You can view the results of those checks to identify specific issues from the output file on each agent machine (%systemroot%\temp\UpmConfigCheckOutput.xml). The feature performs status checks every day or each time the WEM agent host service starts. To perform the status checks manually, select the agent, and then select the Refresh Profile Management Configuration Check from the action bar. Each status check returns a status. To view the most recent status, click Refresh. The icon in the Profile Management Health column provides general information about the health status of Profile Management:

    • Good (check mark icon). Indicates that Profile Management is in good shape.
    • Warning (triangle exclamation point icon). Informs about a suboptimal state of Profile Management. The suboptimal state might affect the user experience with Profile Management in your deployment. This status does not necessarily require action on your part. To view the detailed report, use the View Profile Management health check report option in More.
    • Error (error icon). Indicates that Profile Management is configured incorrectly, causing it not to function properly.
    • Unavailable (disabled icon). Appears when Profile Management is not found or not enabled.

    If the status checks do not reflect your experience or if they do not detect the issues you are having, contact Citrix Technical Support.

You can perform the following operations:

  • Columns to display. Lets you customize the table by choosing which columns you want to display.

  • Refresh. Updates the list of agents.

  • Clear expired records. Lets you delete expired records from the WEM service database. If a user’s last logon time dates back more than 24 hours, the corresponding record expires. Unavailable when you do not have any expired records.

  • View details. Lets you view detailed information about the agent.

  • Export. Lets you export the data in each record in CSV or JSON format, which opens in programs such as Microsoft Excel. To do that, perform the following steps:

    1. Click Export. The export wizard appears.
    2. Select the export format. Available options: CSV and JSON.
    3. Optionally, select Save a copy of the export to your local machine. The export will be saved to the default download location of your browser.
    4. Click Export to start the export process.

    Important:

    • You can export up to 50,000 records. When the number of records to export exceeds the limit, only the top 50,000 will be exported. We recommend that you use filters to reduce the number of records to 50,000 or fewer.
    • While an export is in progress, you cannot perform another export.
    • If an export does not complete within 30 minutes, you will no longer receive notifications about it. Go to Files to view the export result later.
    • When exporting agent statistics, the export will be saved to the cloud storage. The cloud storage has a storage limit. When you reach the limit, you cannot proceed with the export. In that case, go to Files and delete unnecessary files to free up space. See Files.

The following options are available in the More menu. Currently, applying these options to non-domain-joined and enrolled agents is not supported.

Note:

The More menu is available only when you select no more than 50 agents.

"More" options - Agent

Agent:

  • Refresh cache. Triggers a refresh of the local agent cache (an agent-side replica of the WEM configuration database). Refreshing the cache syncs the local agent cache with the infrastructure services.

  • Refresh agent host settings. Triggers a refresh of the agent service settings in the user environment. Those settings include advanced, optimization, transformer, and non-user assigned settings.

  • Refresh UI-mode agent. Applies the user-assigned actions to the WEM agents. Those actions include network drives, printers, applications, and more. When you refresh an agent, it communicates with the infrastructure services. The infrastructure services validate the agent host identity with the WEM database.

    Important:

    • The Refresh UI-mode agent option works only with the agents in UI mode that are automatically launched (not launched by end users or by using scripts). The option does not work with the agents in CMD mode.
    • Not all settings can be refreshed. Some settings (for example, environment and group policy settings) are applied only on startup or logon.
  • Retrieve statistics from agent. Enables the agents to upload statistics to the infrastructure services.

  • Upgrade agent to latest version. Lets you upgrade the agent to the last version. The time at which you perform an agent upgrade determines the latest version of the agent. To see the latest agent version, go to the WEM service Utilities tab.

You can also perform the refresh operations on the agent side. However, those operations behave differently depending on actual conditions. For more information, see Agent-side refresh operations.

"More" options - Profile

Profile:

  • Reset Profile Management settings. Clears the registry cache and updates the associated configuration settings. If Profile Management settings are not applied to your agent, click Reset Profile Management Settings. You might need to click Refresh for this option to become available.

    Note:

    If the settings are not applied to the agent after configuring Reset Profile Management Settings from the WEM administration console, see CTX219086 for a workaround.

  • Run Profile Management health check. Performs status checks on the target agent machines to determine whether Profile Management is configured optimally. After selecting this option, the Run Profile Management health check wizard appears. Select the Profile Management settings that you want to cover in the health check reports and then click Run. Be aware of the following:

    • By default, the health reports cover all settings. For agents earlier than 2205.1.0.1, changes you make to the scope of settings to cover in the report do not take effect.
    • It might take some time before you can see the health reports. In Reports, refresh the view if necessary.
    • Click View reports to access the reports directly.

    Notifications sent to agents

  • View Profile Management health check report. Provides quick access to Profile Management health reports related to the target agent machines. For more information about Profile Management health reports, see Reports.

  • Reset Microsoft USV settings. Clears the registry cache and updates the associated configuration settings. If Microsoft USV settings are not applied to your agent, click Reset Microsoft USV settings. You might need to click Refresh for this option to become available.

Power management:

  • Shut down. Lets you shut down the selected agents.

  • Restart. Lets you restart the selected agents.

  • Sleep. Lets you put the selected agents into sleep mode. This option works only when the target machine supports sleep mode.

  • Hibernate. Lets you put the selected agents into hibernate mode. This option works only when the target machine supports hibernate mode.

  • Wake. Lets you wake up the selected agents. For the option to work, go to Legacy Console > Advanced Settings > Configuration > Wake on LAN and select Enable Wake on LAN for Agents. Also, make sure that the target machines satisfy the hardware requirements and relevant BIOS settings are configured. For more information, see Wake on LAN.

    Tip:

    • When you shut down or restart agents, you can specify a delay (in seconds) before the shutdown or restart begins. Users receive a prompt that the machine will shut down or restart in the amount of time you specify. Shutdown prompt example: Your administrator has initiated the shutdown of your machine from the Workspace Environment Management console. The machine shuts down in 60 seconds.. Restart prompt example: Your administrator has initiated the restart of your machine from the Workspace Environment Management console. The machine restarts in 60 seconds..
    • Consider the differences between sleep and hibernate. In sleep mode, all actions on the machine are stopped, and any open documents and applications are put in memory. The machine goes into a low-power state. In hibernate mode, open documents and running applications are saved to the hard disk. The machine is turned off entirely, using zero power.
    • To verify that the target machine supports sleep and hibernate modes, go to the machine and run the following PowerShell commands: powercfg /a.

Process Citrix Optimizer. Applies the settings to the agents so that changes to Citrix Optimizer settings take effect immediately.

Run scripted task. Lets you run scripted tasks on the target agent machines. After selecting this option, the Run scripted task wizard appears. Configure the following settings and then click Run. For more information about each setting, see Scripted Task Settings.

Note:

This option does not apply to non-domain-joined agents.

  • Task. Select which scripted task you want to run.
  • Pass parameters to the scripted task. Choose whether to pass parameters to the scripted task. When enabled, lets you provide inputs as parameter variables in the scripted task at runtime.
  • Output files. Choose whether you want to collect files that the task outputs. If selected, includes output file content in reports generated for the task. You can then view the output file content in the reports without the need to access the files in the user environment.
  • Highlight keywords. Specify keywords that you want the report to highlight. You can type multiple keywords. After typing a keyword, press Enter to add another. If specified, report contents that match your keywords will be highlighted in the Output file content and Console output sections in the generated reports.
  • Highlight regular expression matches. Enter a regular expression that describes the content you want to highlight. The regular expression must conform to the .NET regular expression library syntax, which is PCRE compatible. For more information, see Scripted Task Settings.

Reset actions. Lets you reset all actions you assigned by purging all action-related registry entries on the applicable agent machine.

Delete record. Deletes the record from the WEM service database. If the agent is still active, this option is unavailable. Available when you select only one agent and its corresponding record has expired.

Administration