Mastering UE-V: Optimizing Windows Client Experience with Registry Settings

Table of Contents

User Experience Virtualization (UE-V) is a powerful tool within the Microsoft Desktop Optimization Pack (MDOP) designed to provide a consistent user experience across different devices. It achieves this by capturing and centralizing application settings and Windows operating system settings, allowing them to roam with the user regardless of which computer they log into. This ensures that users’ personalized configurations, such as application ribbon customizations, desktop backgrounds, and folder options, are available wherever they work.

While UE-V can be configured via Group Policy, many advanced or specific configurations are managed directly through the Windows Registry. Understanding these registry keys and their values is essential for fine-tuning the UE-V agent’s behavior, troubleshooting issues, and optimizing performance within an enterprise environment. Direct registry modification provides granular control beyond the standard policy settings.

Let’s delve into the key registry settings that control the behavior of the UE-V agent, located primarily under HKEY_LOCAL_MACHINE\Software\Microsoft\UEV\Agent\Configuration and HKEY_CURRENT_USER\Software\Microsoft\UEV\Agent\Configuration.

Core UE-V Agent Configuration¶

The foundational settings control whether the UE-V agent is active and where it stores user settings packages. These are fundamental configurations required for UE-V to function correctly within your environment.

Use User Experience Virtualization (SyncEnabled)¶

This is the primary toggle that enables or disables the UE-V agent’s functionality for synchronizing application and Windows settings. When disabled, the agent does not capture, store, or apply any user settings, effectively pausing the UE-V service for that client. Managing this setting allows administrators to activate or deactivate UE-V on specific machines or for specific users as needed, potentially for troubleshooting or staged deployments.

Registry Path: HKEY_LOCAL_MACHINE\Software\Microsoft\UEV\Agent\Configuration and HKEY_CURRENT_USER\Software\Microsoft\UEV\Agent\Configuration
Value Name: SyncEnabled
Value Type: REG_DWORD
Possible Values: 0 (False - Disabled), 1 (True - Enabled)
Default Value: 1 (True)

By default, the UE-V agent is enabled upon installation. Setting this value to 0 will prevent the agent from performing any synchronization operations. Changes to this setting typically require restarting the UE-V agent service or the machine to take full effect.

Settings Storage Path (SettingsStoragePath)¶

This critical setting defines the network location where user settings packages are stored. This path must be a Universal Naming Convention (UNC) path accessible by the user, typically a shared folder on a file server. Using variables like %username% is common to ensure each user’s settings are directed to a unique subfolder within the share, maintaining data isolation and organization.

Registry Path: HKEY_LOCAL_MACHINE\Software\Microsoft\UEV\Agent\Configuration and HKEY_CURRENT_USER\Software\Microsoft\UEV\Agent\Configuration
Value Name: SettingsStoragePath
Value Type: REG_EXPAND_SZ
Possible Values: A valid UNC path (e.g., \\Server\SettingsShare\%username%)
Default Value: Not Specified

It is imperative that the specified storage path has appropriate permissions configured. Users need read, write, and modify permissions to their respective settings folders, while administrators may require full control for management and troubleshooting. Failure to set this path or incorrect permissions will prevent UE-V from saving or loading settings.

Template Management Settings¶

UE-V relies on settings location templates to identify which files, folders, and registry values associated with applications and Windows settings should be synchronized. These settings control where UE-V looks for these templates.

Settings Template Catalog Path (SettingsTemplateCatalogPath)¶

This setting specifies the location where custom or updated settings location templates (.xml files) are stored. This allows administrators to deploy custom templates for applications not included by default or modify the behavior of existing ones. The path can be a network share (UNC) or a local folder on the client machine, providing flexibility in template distribution.

Registry Path: HKEY_LOCAL_MACHINE\Software\Microsoft\UEV\Agent\Configuration
Value Name: SettingsTemplateCatalogPath
Value Type: REG_EXPAND_SZ
Possible Values: A valid UNC or local path (e.g., \\Server\TemplateShare or C:\UEV\Templates)
Default Value: Not Specified

Configuring this path is essential for deploying custom templates created with the UE-V Generator or distributing updated Microsoft templates independently of agent updates. The UE-V agent periodically checks this location for new or modified templates.

Override Microsoft Templates (OverrideMSTemplates)¶

This setting works in conjunction with SettingsTemplateCatalogPath. If set to True, templates found in the specified catalog path will replace the default Microsoft templates that are installed with the UE-V agent. If set to False (the default), the agent will use both the default Microsoft templates and any templates found in the catalog path, adding custom ones rather than replacing defaults.

Registry Path: HKEY_LOCAL_MACHINE\Software\Microsoft\UEV\Agent\Configuration
Value Name: OverrideMSTemplates
Value Type: REG_DWORD
Possible Values: 0 (False), 1 (True)
Default Value: 0 (False)

Setting this to True gives administrators complete control over which templates are active, allowing them to disable default templates by providing an updated version in the catalog that effectively nullifies the original. This is useful for excluding certain applications or settings from roaming.

Synchronization Behavior Settings¶

These settings control how and when the UE-V agent performs synchronization operations, impacting performance, network usage, and the user experience regarding settings availability.

Specify the Synchronization Method (SyncMethod)¶

This setting determines the method the UE-V agent uses to synchronize settings packages with the storage location. Two primary methods are available: OfflineFiles and None. OfflineFiles leverages Windows Offline Files, which is suitable for laptops or machines that may go offline, ensuring settings are available locally and synchronized later. None implies direct synchronization without using Offline Files, best suited for machines that are always connected to the network and can tolerate potential synchronization delays or failures during network outages.

Registry Path: HKEY_LOCAL_MACHINE\Software\Microsoft\UEV\Agent\Configuration and HKEY_CURRENT_USER\Software\Microsoft\UEV\Agent\Configuration
Value Name: SyncMethod
Value Type: REG_SZ
Possible Values: OfflineFiles, None
Default Value: OfflineFiles

Choosing the appropriate synchronization method is crucial for balancing performance and availability. OfflineFiles adds complexity due to the caching mechanism, while None is simpler but requires persistent connectivity to the settings storage path for reliable synchronization.

Enable Notification (SettingsImportNotifyEnabled)¶

When SyncMethod is set to None, settings import happens at login. If the import process is delayed (e.g., due to network latency or large package sizes), this setting controls whether the user receives a notification message. Enabling this notification can improve the user experience by informing them that settings are still being applied, preventing confusion if applications launch with default settings initially.

Registry Path: HKEY_LOCAL_MACHINE\Software\Microsoft\UEV\Agent\Configuration and HKEY_CURRENT_USER\Software\Microsoft\UEV\Agent\Configuration
Value Name: SettingsImportNotifyEnabled
Value Type: REG_DWORD
Possible Values: 0 (False), 1 (True)
Default Value: 0 (False)

This setting is only relevant and functional when SyncMethod is configured to None. If you use OfflineFiles, import delays are handled differently, and this notification will not appear.

Notification Delay (SettingsImportNotifyDelayInSeconds)¶

This setting specifies the duration, in seconds, before the settings import delay notification appears after a user logs in, assuming SettingsImportNotifyEnabled is set to True and SyncMethod is None. It allows administrators to prevent premature notifications for short delays while still informing users about significant delays.

Registry Path: HKEY_LOCAL_MACHINE\Software\Microsoft\UEV\Agent\Configuration and HKEY_CURRENT_USER\Software\Microsoft\UEV\Agent\Configuration
Value Name: SettingsImportNotifyDelayInSeconds
Value Type: REG_DWORD
Possible Values: Delay in seconds (e.g., 10, 20, 30)
Default Value: 10 Seconds

Adjusting this delay can help tailor the notification behavior to your network environment and typical login times. A value too low might trigger unnecessary notifications, while a value too high might mean users don’t get notified of significant delays.

Settings Package Prefetch (PrefetchPackageList)¶

This setting allows administrators to specify a list of settings packages that the UE-V agent should proactively download and cache before the associated applications are launched. Prefetching can significantly improve the perceived application launch time by ensuring settings are immediately available when the user opens the application. This is particularly useful for frequently used or critical applications.

Registry Path: HKEY_LOCAL_MACHINE\Software\Microsoft\UEV\Agent\Configuration
Value Name: PrefetchPackageList
Value Type: REG_MULTI_SZ
Possible Values: A list of settings package names (e.g., MicrosoftCalculator, DesktopSettings, MicrosoftNotepad)
Default Value: DesktopSettings

The package names should be specified without the .uev file extension. Adding too many packages to this list can potentially increase login times as the agent must prefetch all specified items before the user desktop is fully loaded. Careful consideration should be given to which packages are included.

Synchronization Timeout (SyncTimeoutInMilliseconds)¶

This setting configures the maximum amount of time, in milliseconds, that the UE-V agent will wait to retrieve settings packages from the storage location before timing out. A timeout prevents the agent from hanging indefinitely if the network path is unavailable or extremely slow. When a timeout occurs, the agent typically proceeds without applying the synchronized settings for that operation.

Registry Path: HKEY_LOCAL_MACHINE\Software\Microsoft\UEV\Agent\Configuration and HKEY_CURRENT_USER\Software\Microsoft\UEV\Agent\Configuration
Value Name: SyncTimeoutInMilliseconds
Value Type: REG_DWORD
Possible Values: Timeout duration in milliseconds
Default Value: 2000 milliseconds (2 seconds)

Adjusting the timeout value can be useful in environments with varying network conditions. Setting it too low might cause timeouts on a slow network, preventing settings from loading. Setting it too high might cause applications or logins to appear unresponsive while the agent waits for inaccessible resources.

Package Size Warning Threshold (MaxPackageFileSizeInBytes)¶

This setting defines a threshold for the size of settings packages. If a package exceeds this size, the UE-V agent can be configured to report this event, typically logged in the Event Viewer. This is useful for identifying settings templates that capture excessive amounts of data, which can impact synchronization performance and storage consumption.

Registry Path: HKEY_LOCAL_MACHINE\Software\Microsoft\UEV\Agent\Configuration and HKEY_CURRENT_USER\Software\Microsoft\UEV\Agent\Configuration
Value Name: MaxPackageFileSizeInBytes
Value Type: REG_DWORD
Possible Values: Threshold in bytes (or often interpreted in KB by the UI, but the registry value is bytes)
Default Value: 500000 bytes (500 KB)

Monitoring packages that exceed this threshold can help administrators refine their settings templates to exclude unnecessary data, thus optimizing UE-V performance and storage usage.

Offline Threshold (OfflineThreshold)¶

This setting defines how long, in days, a computer can remain offline before the UE-V agent stops exporting settings when it eventually comes back online. This prevents the agent from overwriting recent settings captured by a machine that was online with potentially stale settings from a machine that was offline for a prolonged period.

Registry Path: HKEY_LOCAL_MACHINE\Software\Microsoft\UEV\Agent\Configuration and HKEY_CURRENT_USER\Software\Microsoft\UEV\Agent\Configuration
Value Name: OfflineThreshold
Value Type: REG_DWORD
Possible Values: Threshold duration in days
Default Value: 30 days

Setting this threshold helps maintain data consistency and prevents older settings from overwriting newer ones across different machines used by the same user. It’s a safeguard against data conflicts arising from intermittent connectivity.

Preventing Overlapping Synchronization for Applications (PreventOverlappingSynchronization)¶

This setting prevents synchronization operations for a specific application if another instance of that application is already running. If set to True, UE-V will not import settings at launch if the app is already open, and it will not export settings at shutdown if another instance remains running. This helps prevent potential conflicts or data loss that could occur from multiple instances trying to synchronize simultaneously.

Registry Path: HKEY_LOCAL_MACHINE\Software\Microsoft\UEV\Agent\Configuration and HKEY_CURRENT_USER\Software\Microsoft\UEV\Agent\Configuration
Value Name: PreventOverlappingSynchronization
Value Type: REG_DWORD
Possible Values: 0 (False), 1 (True)
Default Value: 1 (True)

Keeping this setting enabled (the default) is generally recommended for maintaining data integrity, especially for applications that users might open multiple instances of.

Reporting and Miscellaneous Settings¶

These settings control participation in improvement programs, the visibility of settings folders, and provide read-only information about the UE-V agent.

Customer Experience Improvement Program (CustomerExperienceImprovementProgram)¶

This setting determines whether the UE-V agent and/or Generator participates in the Microsoft Customer Experience Improvement Program. If enabled, anonymous usage data might be sent to Microsoft to help improve the product.

Registry Path:
Agent: HKEY_LOCAL_MACHINE\Software\Microsoft\UEV\Agent\Configuration
Generator: HKEY_LOCAL_MACHINE\Software\Microsoft\UEV\Management
Value Name: CustomerExperienceImprovementProgram
Value Type: REG_DWORD
Possible Values: 0 (False), 1 (True)
Default Value: 0 (False)

Organizations often disable participation in such programs for privacy or policy reasons, aligning with the default value.

Hide Settings Package directory (HideSettingsPackagesFolder)¶

This setting controls the visibility of the SettingsPackages folder created for each user on the settings storage location. By default, this folder is hidden and marked as a system folder, preventing accidental modification or deletion by the user. This setting must be configured before the folders are created for it to have effect on new user profiles.

Registry Path: HKEY_LOCAL_MACHINE\Software\Microsoft\UEV\Agent\Configuration and HKEY_CURRENT_USER\Software\Microsoft\UEV\Agent\Configuration
Value Name: HideSettingsPackagesFolder
Value Type: REG_DWORD
Possible Values: 0 (False - Visible), 1 (True - Hidden and System)
Default Value: 1 (True)

Maintaining the default hidden state is recommended to protect user settings data from inadvertent user intervention.

Roaming Scope Settings¶

These settings allow granular control over which Windows settings and applications are included in the UE-V roaming process.

Roaming Windows settings (Under WindowsSettings Key)¶

This section of the registry controls the roaming status for specific categories of Windows settings as defined by their corresponding settings location templates. Each Windows settings template is represented by its unique ID as a value name under the WindowsSettings key.

Registry Path: HKEY_LOCAL_MACHINE\Software\Microsoft\UEV\Agent\Configuration\WindowsSettings
Value Name: ID of the settings location template (e.g., {Some-GUID-Representing-DesktopSettings})
Value Type: REG_DWORD
Possible Values: 0 (False - Do not roam), 1 (True - Roam)
Default Value: DesktopSettings=False, EaseofAccess=False, (all other Windows settings templates default to true)

Administrators can use this to disable roaming for specific Windows settings categories that might cause conflicts or are not desired in their environment. For example, disabling Desktop Settings prevents the user’s background and theme from roaming.

Roaming Application settings (Under Applications Key)¶

Similar to Windows settings, this registry key controls whether settings for specific applications are roamed. Each application whose roaming status is explicitly managed is represented by its settings location template ID as a value name under the Applications key.

Registry Path: HKEY_LOCAL_MACHINE\Software\Microsoft\UEV\Agent\Configuration\Applications
Value Name: ID of the settings location template
Value Type: REG_DWORD
Possible Values: 0 (False - Do not roam), 1 (True - Roam)
Default Value: Not Specified (all applications default to true unless explicitly disabled here or by policy)

This provides granular control over application settings roaming, allowing administrators to disable roaming for problematic applications or those whose settings are not suitable for synchronization.

Informational Registry Values¶

These values are typically managed by the UE-V agent itself and are read-only for administrative purposes.

Active Directory Settings Storage Path (ADSettingsStoragePath)¶

This value records the settings storage path if it was configured via the user’s Active Directory home directory setting. It is populated by the UE-V agent and should not be manually edited.

Registry Path: HKEY_CURRENT_USER\Software\Microsoft\UEV\Agent\Configuration
Value Name: ADSettingsStoragePath
Value Type: REG_EXPAND_SZ
Possible Values: UE-V Agent defined
Default Value: Empty

This provides insight into how the settings storage path was determined for a specific user.

Install Time Stamp (InstallTimestamp)¶

This value records the timestamp of the UE-V agent installation. It is used internally by the agent and should not be manually edited.

Registry Path: HKEY_LOCAL_MACHINE\Software\Microsoft\UEV\Agent\Configuration
Value Name: InstallTimestamp
Value Type: REG_QWORD
Possible Values: UE-V Agent defined
Default Value: Empty

This can be useful for auditing or troubleshooting installation-related issues.

Excluded FileTypes (ExcludedFileTypes)¶

This setting allows administrators to specify a list of file extensions that should be explicitly excluded from settings synchronization, regardless of the settings location templates. This is a global exclusion list.

Registry Path: HKEY_LOCAL_MACHINE\Software\Microsoft\UEV\Agent\Configuration
Value Name: ExcludedFileTypes
Value Type: REG_MULTI_SZ
Possible Values: List of file extensions (e.g., .tmp, .log, .bak)
Default Value: Empty

Excluding certain file types can help reduce package size and prevent synchronization of temporary or unnecessary files that might be captured by templates.

Summary Table of Key UE-V Registry Settings¶

Setting Name	Registry Path	Value Name	Type	Default Value	Description
Use UE-V	...\UEV\Agent\Configuration	SyncEnabled	REG_DWORD	1 (True)	Enables or disables the UE-V agent.
Settings storage path	...\UEV\Agent\Configuration	SettingsStoragePath	REG_EXPAND_SZ	Not Specified	Configures the UNC path for storing user settings packages.
Settings template catalog path	HKEY_LOCAL_MACHINE\...\UEV\Agent\Configuration	SettingsTemplateCatalogPath	REG_EXPAND_SZ	Not Specified	Configures the path for custom or updated settings location templates.
Override Microsoft Templates	HKEY_LOCAL_MACHINE\...\UEV\Agent\Configuration	OverrideMSTemplates	REG_DWORD	0 (False)	Determines if the template catalog replaces default Microsoft templates.
Synchronization Method	...\UEV\Agent\Configuration	SyncMethod	REG_SZ	OfflineFiles	Configures the synchronization method (OfflineFiles or None).
Enable Notification	...\UEV\Agent\Configuration	SettingsImportNotifyEnabled	REG_DWORD	0 (False)	Enables notification if settings import is delayed (SyncMethod = None only).
Notification Delay	...\UEV\Agent\Configuration	SettingsImportNotifyDelayInSeconds	REG_DWORD	10 Seconds	Delay before the import delay notification appears.
Settings Package Prefetch	HKEY_LOCAL_MACHINE\...\UEV\Agent\Configuration	PrefetchPackageList	REG_MULTI_SZ	DesktopSettings	Specifies settings packages to pre-cache before application launch.
Synchronization timeout	...\UEV\Agent\Configuration	SyncTimeoutInMilliseconds	REG_DWORD	2000 ms	Configures the maximum wait time for settings retrieval.
Package size warning threshold	...\UEV\Agent\Configuration	MaxPackageFileSizeInBytes	REG_DWORD	500000 bytes	Threshold for reporting large settings packages.
Offline Threshold	...\UEV\Agent\Configuration	OfflineThreshold	REG_DWORD	30 days	Defines how long a machine can be offline before export is prevented.
Prevent Overlapping Synchronization	...\UEV\Agent\Configuration	PreventOverlappingSynchronization	REG_DWORD	1 (True)	Prevents sync if another instance of the app is running.
Customer Experience Improvement Program	Agent: ...\UEV\Agent\Configuration Generator: ...\UEV\Management	CustomerExperienceImprovementProgram	REG_DWORD	0 (False)	Opt-in for telemetry data submission.
Hide Settings Package directory	...\UEV\Agent\Configuration	HideSettingsPackagesFolder	REG_DWORD	1 (True)	Controls visibility of the user’s settings folder on the share.
Roaming Windows settings	HKEY_LOCAL_MACHINE\...\UEV\Agent\Configuration\WindowsSettings	Template ID	REG_DWORD	Varies	Enables/disables roaming for specific Windows settings categories.
Roaming Application settings	HKEY_LOCAL_MACHINE\...\UEV\Agent\Configuration\Applications	Template ID	REG_DWORD	Not Specified	Enables/disables roaming for specific applications.
Excluded FileTypes	HKEY_LOCAL_MACHINE\...\UEV\Agent\Configuration	ExcludedFileTypes	REG_MULTI_SZ	Empty	Global list of file types to exclude from synchronization.

Practical Considerations and Troubleshooting¶

Managing UE-V through the registry requires careful attention to detail. Incorrectly modifying registry values can lead to unexpected behavior or disrupt settings synchronization entirely. Always back up the registry before making changes and test modifications on a small group of pilot users before deploying broadly.

For enterprise deployments, managing these settings is typically done using Group Policy Preferences or configuration management tools like Microsoft Endpoint Manager (SCCM/Intune) rather than direct manual registry edits on each machine. Group Policy Templates (.admx and .adml files) are available for many UE-V settings, simplifying deployment and ensuring consistency. However, understanding the underlying registry keys remains vital for advanced troubleshooting or configuring settings not exposed via standard GPOs.

When troubleshooting UE-V, the Event Viewer logs (specifically under Applications and Services Logs\Microsoft\User Experience Virtualization\Agent) are invaluable. Error or warning events often reference issues related to these registry configurations, such as inaccessible storage paths or template processing errors. Checking the relevant registry keys against the documented values and your intended configuration is a standard troubleshooting step.

Consider the performance implications of settings like PrefetchPackageList and SyncTimeoutInMilliseconds. While prefetching can improve application launch, excessive prefetching or insufficient timeouts on slow networks can degrade user experience during login or application startup.

Further Resources¶

Understanding UE-V configurations goes beyond just the registry. Learning about settings location templates, the UE-V Generator tool, and integrating UE-V with other profile management solutions like Folder Redirection and AppLocker provides a comprehensive approach to user experience management.

For visual learners, exploring videos on UE-V deployment and management can be helpful. While there might not be a specific video focusing solely on registry keys, general setup guides often touch upon these configuration aspects.

For example, here is a video that provides an overview of UE-V that might offer additional context (Note: Specific content may vary and is subject to the video creator’s upload):

https://www.youtube.com/watch?v=ExampleVideoId

(Note: Replace ExampleVideoId with the actual ID of a relevant YouTube video about Microsoft UE-V deployment or management if available.)

Mastering these registry settings provides administrators with the necessary tools to customize and optimize the UE-V agent’s behavior, ensuring a seamless and consistent user experience across diverse Windows environments.

What are your experiences managing UE-V via the registry? Have you encountered specific challenges or found particular settings especially useful in your environment? Share your thoughts in the comments below!