Table of contents

Get Started with UE-V 2.x

jamiejdt|Last Updated: 9/1/2016
1 Contributor

Follow the steps in this guide to quickly deploy Microsoft User Experience Virtualization (UE-V) 2.0 or 2.1 in a small test environment. This helps you determine whether UE-V is the right solution to manage user settings across multiple devices within your enterprise.

The information in this section is repeated in greater detail throughout the rest of the documentation. So if you already know that UE-V 2 is the right solution and you don’t need to evaluate it, you can just go right to Prepare a UE-V 2.x Deployment.

The standard installation of UE-V synchronizes the default Microsoft Windows and Office settings and many Windows app settings. Make sure your test environment includes two or more user computers that share network access and you’ll be evaluating UE-V in just a short time.

That’s it! Once you follow the steps, you’ll be able to evaluate how UE-V can work in your enterprise.

Further evaluation: You can also perform additional steps to configure some third-party and line-of-business applications to synchronize their settings using UE-V as detailed in Deploy UE-V 2.x for Custom Applications.

Step 1: Confirm Prerequisites

Before you proceed, make sure your environment includes these requirements for running UE-V.

Operating systemEditionService packSystem architectureWindows PowerShellMicrosoft .NET Framework

Windows 7

Ultimate, Enterprise, or Professional Edition


32-bit or 64-bit

Windows PowerShell 3.0 or higher

.NET Framework 4 or higher

Windows Server 2008 R2

Standard, Enterprise, Datacenter, or Web Server



Windows PowerShell 3.0 or higher

.NET Framework 4 or higher

Windows 8 and Windows 8.1

Enterprise or Pro


32-bit or 64-bit

Windows PowerShell 3.0 or higher

.NET Framework 4.5

Windows Server 2012 or Windows Server 2012 R2

Standard or Datacenter



Windows PowerShell 3.0 or higher

.NET Framework 4.5


  • MDOP License: This technology is a part of the Microsoft Desktop Optimization Pack (MDOP). Enterprise customers can get MDOP with Microsoft Software Assurance. For more information about Microsoft Software Assurance and acquiring MDOP, see How Do I Get MDOP (

  • Administrative Credentials for any computer on which you’ll be installing

Step 2: Deploy the Settings Storage Location for UE-V 2

You’ll need to deploy a settings storage location, a standard network share where user settings are stored in a settings package file. When you create the settings storage share, you should limit access to users that require it. Deploy a Settings Storage Location provides more detailed information.

Create a network share

  1. Create a new security group and add UE-V users to it.

  2. Create a new folder on the centrally located computer that stores the UE-V settings packages, and then grant the UE-V users access with group permissions to the folder. The administrator who supports UE-V must have permissions to this shared folder.

  3. Assign UE-V users permission to create a directory when they connect. Grant full permission to all subdirectories of that directory, but block access to anything above.

    1. Set the following share-level Server Message Block (SMB) permissions for the settings storage location folder.

      User accountRecommended permissions


      No permissions

      Security group of UE-V users

      Full control

    2. Set the following NTFS file system permissions for the settings storage location folder.

      User accountRecommended permissionsFolder


      Full control

      Subfolders and files only

      Security group of UE-V users

      List folder/read data, create folders/append data

      This folder only

**Security Note: **

If you create the settings storage share on a computer running a Windows Server operating system, configure UE-V to verify that either the local Administrators group or the current user is the owner of the folder where settings packages are stored. To enable this additional security, specify this setting in the Windows Server Registry Editor:

  1. Add a REG_DWORD registry key named "RepositoryOwnerCheckEnabled" to HKEY_LOCAL_MACHINE\Software\Microsoft\UEV\Agent\Configuration.

  2. Set the registry key value to 1.

Step 3: Deploy the UE-V 2 Agent

The UE-V Agent synchronizes application and Windows settings between users’ computers and devices. For evaluation purposes, install the agent on at least two computers in your test environment that belong to the same user.

Run the AgentSetup.exe file from the command line to install the UE-V Agent. It installs on both 32-bit and 64-bit operating systems.

AgentSetup.exe SettingsStoragePath=\\server\settingsshare\%username%

You must specify the SettingsStoragePath command line parameter as the network share from Step 2. Deploy a UE-V Agent provides more detailed information.

Step 4: Test Your UE-V 2 Evaluation Deployment

You can now run a few tests on your UE-V evaluation deployment to see how UE-V works.

  1. On the first computer (Computer A), make one or more of these changes:

    1. Open to Windows Desktop and move the taskbar to a different location in the window.

    2. Change the default fonts.

    3. Open Calculator and set to scientific.

    4. Change the behavior of any Windows app, as detailed in Managing UE-V 2.x Settings Location Templates Using Windows PowerShell and WMI.

    5. Disable Microsoft Account settings synchronization and Roaming Profiles.

  2. Log off Computer A. Settings are saved in a UE-V settings package when users lock, logoff, exit an application, or when the sync provider runs (every 30 minutes by default).

  3. Log in to the second computer (Computer B) as the same user as Computer A.

  4. Open to Windows Desktop and verify that the taskbar location matches that of Computer A. Verify that the default fonts match and that Calculator is set to scientific. Also verify the change you made to any Windows app.

You can change the settings in Computer B back to the original Computer A settings. Then log off Computer B and log in to Computer A to verify the changes.

Other resources for this product

Got a suggestion for UE-V?

Add or vote on suggestions here. For UE-V issues, use the UE-V TechNet Forum.

© 2017 Microsoft