Product Documentation

What’s new

A goal of Citrix is to deliver new features and product updates to Workspace Environment Management service customers when they are available. New releases provide more value, so there is no reason to delay updates. Updates are rolled out to the service release approximately every three weeks.

This process is transparent to you. Initial updates are applied to Citrix internal sites only, and are then applied to customer environments gradually. Delivering updates incrementally in waves helps ensure product quality and maximize availability.

For information about the service level goal for the Workspace Environment Management service for cloud scale and service availability, see Service Level Goals. To monitor service interruptions and scheduled maintenance, see the Service Health Dashboard.

New product names

If you’ve been a Citrix customer or partner for a while, you’ll notice new names in our products and in this product documentation. If you’re new to this Citrix product, you might see different names for a product or component.

The new product and component names stem from the expanding Citrix portfolio and cloud strategy. Articles in this product documentation use the following names.

  • Citrix Virtual Apps and Desktops: Citrix Virtual Apps and Desktops offers a virtual app and desktop solution, provided as a cloud service and as an on-premises product, giving employees the freedom to work from anywhere on any device while cutting IT costs. Deliver Windows, Linux, web, and SaaS applications or full virtual desktops from any cloud: public, on premises or hybrid. Virtual Apps and Desktops was formerly XenApp and XenDesktop.

  • Citrix Workspace app: The Citrix Workspace app incorporates existing Citrix Receiver technology as well as the other Citrix Workspace client technologies. It has been enhanced to deliver additional capabilities to provide end users with a unified, contextual experience where they can interact with all the work apps, files, and devices they need to do their best work. For more information, see this blog post.

  • Citrix Provisioning: The Citrix Provisioning is a solution for managing virtual machine images, combining previous technologies known as Machine Creation Services (MCS) and Citrix Provisioning Services (PVS). Citrix Provisioning was formerly Provisioning Services.

Here’s a quick recap:

Is Was
Citrix Virtual Apps and Desktops XenApp and XenDesktop
Citrix Workspace app Citrix Receiver
Citrix Provisioning Provisioning Services

Implementing this transition in our products and their documentation is an ongoing process.

  • In-product content might still contain former names. For example, you might see instances of earlier names in console text, messages, and directory/file names.

  • It is possible that some items (such as commands and MSIs) might continue to retain their former names to prevent breaking existing customer scripts.

  • Related product documentation and other resources (such as videos and blog posts) that are linked from this product’s documentation might still contain former names.

Your patience during this transition is appreciated. For more detail about our new names, see


Agents for the Workspace Environment Management service are different from agents for the on-premises version of Workspace Environment Management. The service-specific agents release on the same schedule as other Workspace Environment Management service components, features, and technologies. Generally, the service-specific agents release at the same time as the Workspace Environment Management service product.

  • For information about agent platforms and features that are no longer supported, see Deprecation. The Deprecation article also includes platforms and features that are scheduled to be unsupported in a future release (such as which operating systems support agent installation).

Database migration

A new process allows you to migrate an on-premises Workspace Environment Management database to the Workspace Environment Management service. The process is provided on the WEM service’s Downloads tab. For more information, see Migrate.

Administration console

The administration console user interface changes:

  • An “Everyone” default group is provided on the Assignments > Action Assignment tab. To simplify assigning actions for all users in Active Directory, you can use the “Everyone” default group to assign the actions.

  • A Profile Management health status column is provided on the Administration > Agents > Statistics tab. As of this release, Workspace Environment Management supports performing automated status checks on your agent hosts to determine whether Profile Management is configured optimally. You can view the status in the column.

Profile Management

As of this release, Workspace Environment Management service supports configuring all settings for Citrix Profile Management 1808. The following new options are now available in the administration console on the service’s Manage tab:

  • Enable application profiler (option for defining application-based profile handling)
  • Enable search index roaming for Microsoft Outlook users (option for improving the user experience when searching mail in Microsoft Outlook)
  • Enable Large File Handling (option for eliminating the need to synchronize large files over the network)


The following issues have been fixed in the current release:

  • In the Security tab, when you clear the option Process DLL Rules, the rule count reported next to the “DLL Rules” collection is set to zero, regardless of the actual number in the WEM database. [WEM-425]

  • The Workspace Environment Management Agent Host screen capture feature allows end users to take screenshots of error messages in their environment. They can then send the screenshots to the administrator via Microsoft Outlook for support. However, when end users click the Send to Support button, the following error message appears: “Error encountered while sending email.” [WEM-1123]

  • Attempts to upgrade the WEM database using the command line might fail. [WEM-1410]

  • The on-premises version of WEM lets you use Active Directory security groups as containers for WEM agents. However, the WEM service does not support using Active Directory security groups as agent containers. The on-premises infrastructure service also supports using direct and indirect OUs as agent containers. For example, suppose WEM agent AGENT1 belongs to OU2, and OU2 belongs to OU1 (OU1>OU2>AGENT1). The on-premises infrastructure service recognizes AGENT1 as a member of both OU1 and OU2. However, the WEM service does not support indirect OUs. In the example above, the WEM service recognizes AGENT1 only as a member of OU2. [WEM-1619]

  • In the WEM administration console’s Assignments section, when you use the Modeling wizard for a global view of WEM actions assigned to a specific user, the User Groups tab in the Actions Modeling wizard displays the groups to which the user belongs. However, in WEM service, the User Groups tab in the Actions Modeling wizard does not display the groups to which the user belongs. [WEM-1632]

  • After you apply a percentage of the CPU’s processing power for a process on the System Optimization > CPU Management > CPU Clamping tab of the administration console for the first time and configure a different percentage for the same process later, the change does not take effect. [WEM-1993, LD0110]

  • After you upgrade the WEM agent to Version 4.7, if you select Enable Intelligent CPU Optimization and/or Enable Intelligent I/O Optimization on the System Optimization > CPU Management > CPU Management Settings tab of the administration console, error messages about Error 87 frequently appear in Windows Event logs. This issue does not affect the user experience, thus you can dismiss these error messages. [WEM-2051]

  • When the Citrix WEM agent starts, a Citrix WEM Agent Init file (.log) and a Citrix WEM Agent file (.log) are created separately in the root of the current user’s Users folder. However, while WEM agent switches from the Citrix WEM Agent Init file to the Citrix WEM Agent file, some logs might be missing. [WEM-2233]

August 2018

Agent 1807

Agent group policy template: This template allows you to specify a list of Citrix Cloud Connectors. You must do this before you install the agent. See Install and configure.

Workspace Environment Management service agent: A service-specific agent is provided which has the ability to connect to the Workspace Environment Management service. You must deploy Citrix Cloud Connector in your user domain before you install the agent. See Install and configure.

Administration console

Workspace Environment Management administration console: A web-based administration console is provided to manage your WEM installation from the service’s Manage tab using your web browser. This provides the same functionality as the on-prem version of the administration console.

Search index roaming for Microsoft Outlook users: A new option is provided to improve the user experience when searching mail in Microsoft Outlook. See Citrix Profile Management Settings.


What’s new