deepblue/windows-itpro-docs
1
0
Fork 0
mirror of https://github.com/MicrosoftDocs/windows-itpro-docs.git synced 2025-05-28 13:17:23 +00:00
Code Issues Actions 3 Packages Projects Releases Wiki Activity

Merge pull request #84 from JanKeller1/6641851a

Browse Source 
Overhauling some key UE-V topics, adding images
This commit is contained in:
Brian Lich 2016-07-28 09:18:41 -07:00 committed by GitHub
commit 79d616fd2d
13 changed files with 600 additions and 1315 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

BIN
windows/manage/images/uev-adk-select-uev-feature.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 60 KiB

BIN
windows/manage/images/uev-checklist-box.gif Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 848 B

BIN
windows/manage/images/uev-deployment-preparation.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 6.4 KiB

432
windows/manage/uev-deploy-required-features.md
View File

@ -1,6 +1,6 @@
---
title: Deploy Required Features for UE-V 2.x
description: Deploy Required Features for UE-V 2.x
title: Deploy required UE-V features
description: Deploy required UE-V features
author: jamiejdt
ms.pagetype: mdop, virtualization
ms.mktglfcycl: deploy
@ -8,28 +8,25 @@ ms.sitesec: library
ms.prod: w10
---
# Deploy required UE-V features
# Deploy Required Features for UE-V 2.x
To get up and running with User Experience Virtualization, install and configure the following features.
All Microsoft User Experience Virtualization (UE-V) deployments require these features
- [Deploy a Settings Storage Location](#ssl) that is accessible to end users.
- [Deploy a settings storage location](#deploy-a-ue-v-settings-storage-location) that is accessible to end users.
This is a standard network share that stores and retrieves user settings.
- [Choose the Configuration Method for UE-V](#config)
- [Choose the configuration method for UE-V](#choose-the-configuration-method-for-ue-v)
UE-V can be deployed and configured using common management tools including group policy, Configuration Manager, or Windows Management Infrastructure and Powershell.
You can deploy and configure UE-V with common management tools including group policy, Configuration Manager, or Windows Management Infrastructure and PowerShell.
- [Deploy a UE-V Agent](#agent) to be installed on every computer that synchronizes settings.
- [Enable the UE-V service](#enable-the-ue-v-service) on user devices.
This monitors registered applications and the operating system for any settings changes and synchronizes those settings between computers.
With Windows 10, version 1607, UE-V is installed automatically. You need to enable the UE-V service on each user device you want to include in your UE-V environment.
The topics in this section describe how to deploy these features.
## <a href="" id="ssl"></a>Deploy a UE-V Settings Storage Location
## Deploy a UE-V Settings Storage Location
UE-V requires a location in which to store user settings in settings package files. You can configure this settings storage location in one of these ways:
@ -37,420 +34,135 @@ UE-V requires a location in which to store user settings in settings package fil
- Use existing Active Directory for your settings storage location
If you don’t create a settings storage location, the UE-V Agent will use Active Directory (AD) by default.
**Note**  
As a matter of [performance and capacity planning](http://technet.microsoft.com/library/dn458932.aspx#capacity) and to reduce problems with network latency, create settings storage locations on the same local networks where the users’ computers reside. We recommend 20 MB of disk space per user for the settings storage location.
 
**Note**
As a matter of [performance and capacity planning](uev-prepare-for-deployment.md#performance-and-capacity-planning) and to reduce problems with network latency, create settings storage locations on the same local networks where the users’ devices reside. We recommend 20 MB of disk space per user for the settings storage location.
### Create a UE-V Settings Storage Location
Before you define the settings storage location, you must create a root directory with read/write permissions for users who store settings on the share. The UE-V Agent creates user-specific folders under this root directory.
Before you define the settings storage location, you must create a root directory with read/write permissions for users who store settings on the share. The UE-V service creates user-specific folders under this root directory.
The settings storage location is defined by setting the SettingsStoragePath configuration option, which you can configure by using one of these methods:
- When you [Deploy the UE-V Agent](#agent) through a command-line parameter or in a batch script
<!--TOMMY IS ANSWERING A QUESTION ABOUT THE FOLLOWING ITEM - IT MIGHT NOT ACTUALLY WORK AS DESCRIBED, NOW THAT IT'S A SERVICE YOU ENABLE RATHER THAN AN AGENT YOU DEPLOY.
- When you [Enable the UE-V service](#enable-the-ue-v-service) through a command-line parameter or in a batch script
-->
- Through [Group Policy](http://technet.microsoft.com/library/dn458893.aspx) settings
- Through [Group Policy](uev-configuring-uev-with-group-policy-objects.md) settings
- With the [System Center Configuration Pack](http://technet.microsoft.com/library/dn458917.aspx) for UE-V
- With the [System Center Configuration Pack](uev-configuring-uev-with-system-center-configuration-manager-2012.md) for UE-V
- After installation of the UE-V Agent, by using [Windows PowerShell or Windows Management Instrumentation (WMI)](http://technet.microsoft.com/library/dn458937.aspx)
- After you enable the UE-V service, by using [Windows PowerShell or Windows Management Instrumentation (WMI)](uev-administering-uev-with-windows-powershell-and-wmi.md)
The path must be in a universal naming convention (UNC) path of the server and share. For example, **\\\\Server\\Settingsshare\\**. This configuration option supports the use of variables to enable specific synchronization scenarios. For example, you can use the `%username%\%computername%` variables to preserve the end user settings experience in these scenarios:
The path must be in a universal naming convention (UNC) path of the server and share. For example, **\\\\Server\\Settingsshare\\**. This configuration option supports the use of variables to enable specific synchronization scenarios. For example, you can use the %username%\\%computername% variables to preserve the end user settings experience in these scenarios:
- End users that use multiple physical computers in your enterprise
- End users that use multiple physical devices in your enterprise
- Enterprise computers that are used by multiple end users
The UE-V Agent dynamically creates a user-specific settings storage path, with a hidden system folder named `SettingsPackages`, based on the configuration setting of **SettingsStoragePath**. The agent reads and writes settings to this location as defined by the registered UE-V settings location templates.
The UE-V service dynamically creates a user-specific settings storage path, with a hidden system folder named SettingsPackages, based on the configuration setting of **SettingsStoragePath**. The service reads and writes settings to this location as defined by the registered UE-V settings location templates.
**UE-V settings are determined by a "Last write wins" rule:** If the settings storage location is the same for user with multiple managed computers, one UE-V Agent reads and writes to the settings location independently of agents running on other computers. The last written settings and values are the ones applied when the next agent reads from the settings storage location.
**UE-V settings are determined by a "Last write wins" rule:** If the settings storage location is the same for a user with multiple managed computers, one UE-V service reads and writes to the settings location independently of services running on other computers. The last written settings and values are the ones applied when the service next reads from the settings storage location.
**Deploy the settings storage location:** Follow these steps to define the settings storage location rather than using your existing Active Directory service. You should limit access to the settings storage share to those users that require it, as shown in the tables below.
**Deploy the settings storage location:** Follow these steps to define the settings storage location rather than using your existing Active Directory agent. You should limit access to the settings storage share to those users that require it, as shown in the tables below.
**To deploy the UE-V network share**
**To deploy the UE-V network share:**
1. Create a new security group for UE-V users.
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.
2. Create a new folder on the centrally located computer that stores the UE-V settings packages, and then grant UE-V users access with group permissions to the folder. The administrator who supports UE-V must have permissions to this shared folder.
3. Set the following share-level Server Message Block (SMB) permissions for the settings storage location folder.
<table>
<colgroup>
<col width="50%" />
<col width="50%" />
</colgroup>
<thead>
<tr class="header">
<th align="left"><strong>User account</strong></th>
<th align="left"><strong>Recommended permissions</strong></th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td align="left"><p>Everyone</p></td>
<td align="left"><p>No permissions</p></td>
</tr>
<tr class="even">
<td align="left"><p>Security group of UE-V users</p></td>
<td align="left"><p>Full control</p></td>
</tr>
</tbody>
</table>
| **User account** | **Recommended permissions** |
|------------------------------|-----------------------------|
| Everyone | No permissions |
| Security group of UE-V users | Full control |
 
1. Set the following NTFS file system permissions for the settings storage location folder.
4. Set the following NTFS file system permissions for the settings storage location folder.
| **User account** | **Recommended permissions** | **Folder** |
|------------------------------|---------------------------------------------------|---------------------------|
| Creator/owner | Full control | Subfolders and files only |
| Security group of UE-V users | List folder/read data, create folders/append data | This folder only |
<table>
<colgroup>
<col width="33%" />
<col width="33%" />
<col width="33%" />
</colgroup>
<thead>
<tr class="header">
<th align="left"><strong>User account</strong></th>
<th align="left"><strong>Recommended permissions</strong></th>
<th align="left"><strong>Folder</strong></th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td align="left"><p>Creator/owner</p></td>
<td align="left"><p>Full control</p></td>
<td align="left"><p>Subfolders and files only</p></td>
</tr>
<tr class="even">
<td align="left"><p>Security group of UE-V users</p></td>
<td align="left"><p>List folder/read data, create folders/append data</p></td>
<td align="left"><p>This folder only</p></td>
</tr>
</tbody>
</table>
With this configuration, the UE-V service creates and secures a Settingspackage folder while it runs in the context of the user, and grants each user permission to create folders for settings storage. Users receive full control to their Settingspackage folder while other users cannot access it.
 
With this configuration, the UE-V Agent creates and secures a Settingspackage folder while it runs in the context of the user, and grants each user permission to create folders for settings storage. Users receive full control to their Settingspackage folder while other users cannot access it.
**Note**  
**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*.
 
### Use Active Directory with UE-V
### Use Active Directory with UE-V 2.x
The UE-V service uses Active Directory (AD) by default if you don’t define a settings storage location. In these cases, the UE-V service dynamically creates the settings storage folder under the root of the AD home directory of each user. However, if a custom directory setting is configured in AD, then that directory is used instead.
The UE-V Agent uses Active Directory (AD) by default if a settings storage location is not otherwise defined. In these cases, the UE-V Agent dynamically creates the settings storage folder under the root of the AD home directory of each user. But, if a custom directory setting is configured in AD, then that directory is used instead.
## Choose the Configuration Method for UE-V
## <a href="" id="config"></a>Choose the Configuration Method for UE-V 2.x
You want to figure out which configuration method you'll use to manage UE-V after deployment since this will be the configuration method you use to deploy the UE-V Agent. Typically, this is the configuration method that you already use in your environment, such as Windows PowerShell or Configuration Manager.
You’ll need to decide which configuration method you'll use to manage UE-V after deployment since this will be the configuration method you use to deploy the UE-V Agent. Typically, this is the configuration method that you already use in your environment, such as Windows PowerShell or Configuration Manager.
You can configure UE-V before, during, or after UE-V Agent installation, depending on the configuration method that you use.
- [Group Policy](http://technet.microsoft.com/library/dn458893.aspx)**:** You can use your existing Group Policy infrastructure to configure UE-V before or after UE-V Agent deployment. The UE-V Group Policy ADMX template enables the central management of common UE-V Agent configuration options, and it includes settings to configure UE-V synchronization.
- [Group Policy](uev-configuring-uev-with-group-policy-objects.md)**:** You can use your existing Group Policy infrastructure to configure UE-V before or after UE-V Agent deployment. The UE-V Group Policy ADMX template enables the central management of common UE-V Agent configuration options, and it includes settings to configure UE-V synchronization.
**Installing the UE-V Group Policy ADMX Templates:** Group Policy ADMX templates for UE-V configure the synchronization settings for the UE-V Agent and enable the central management of common UE-V Agent configuration settings by using an existing Group Policy infrastructure.
**Installing the UE-V Group Policy ADMX Templates:** Group Policy ADMX templates for UE-V configure the synchronization settings for the UE-V Agent and enable the central management of common UE-V Agent configuration settings by using an existing Group Policy infrastructure.
Supported operating systems for the domain controller that deploys the Group Policy Objects include the following:
Supported operating systems for the domain controller that deploys the Group Policy Objects include the following:
Windows Server 2008 R2
Windows Server 2008 R2
Windows Server 2012 and Windows Server 2012 R2
Windows Server 2012 and Windows Server 2012 R2
- [Configuration Manager](http://technet.microsoft.com/library/dn458917.aspx)**:** The UE-V Configuration Pack lets you use the Compliance Settings feature of System Center Configuration Manager 2012 SP1 or later to apply consistent configurations across sites where UE-V and Configuration Manager are installed.
- [Configuration Manager](uev-configuring-uev-with-system-center-configuration-manager-2012.md)**:** The UE-V Configuration Pack lets you use the Compliance Settings feature of System Center Configuration Manager 2012 SP1 or later to apply consistent configurations across sites where UE-V and Configuration Manager are installed.
- [Windows PowerShell and WMI](http://technet.microsoft.com/library/dn458937.aspx)**:** You can use scripted commands for Windows PowerShell and Windows Management Instrumentation (WMI) to modify configurations after you install the UE-V Agent.
- [Windows PowerShell and WMI](uev-administering-uev-with-windows-powershell-and-wmi.md)**:** You can use scripted commands for Windows PowerShell and Windows Management Instrumentation (WMI) to modify configurations after you enable the UE-V service.
**Note**  
Registry modification can result in data loss, or the computer becomes unresponsive. We recommend that you use other configuration methods.
**Note**
Registry modification can result in data loss, or the computer becomes unresponsive. We recommend that you use other configuration methods.
 
<!--TOMMY IS ANSWERING A QUESTION ABOUT THE FOLLOWING ITEM - IT MIGHT NOT ACTUALLY WORK AS DESCRIBED, NOW THAT IT'S A SERVICE YOU ENABLE RATHER THAN AN AGENT YOU DEPLOY.
- **Command-line or Batch Script Installation:** Parameters that are used when you [Enable the UE-V service](#enable-the-ue-v-service) configure many UE-V settings. Electronic software distribution systems, such as System Center 2012 Configuration Manager, use these parameters to configure their clients when they deploy and install the UE-V Agent software.
-->
- **Command-line or Batch Script Installation:** Parameters that are used when you [Deploy the UE-V Agent](#agent) configure many UE-V settings. Electronic software distribution systems, such as System Center 2012 Configuration Manager, use these parameters to configure their clients when they deploy and install the UE-V Agent software.
## Enable the UE-V service
## <a href="" id="agent"></a>Deploy the UE-V 2.x Agent
The UE-V service is the client-side component that captures user-personalized application and Windows settings and saves them in settings packages. Settings packages are built, locally stored, and copied to the settings storage location.
Before enabling the UE-V service, ensure that you’ve completed the following tasks:
The UE-V Agent is the core of a UE-V deployment and must run on each computer that uses UE-V to synchronize application and Windows settings.
- Configure the settings storage location
**UE-V Agent Installation Files:** A single installation file, AgentSetup.exe, installs the UE-V Agent on both 32-bit and 64-bit operating systems. In addition, AgentSetupx86.msi or AgentSetupx64.msi architecture-specific Windows Installer files are provided, and since they are smaller, they might streamline the agent deployments. The [command-line parameters for the AgentSetup.exe installer](#params) are supported for the Windows Installer installation as well.
- Configure the template storage location path
**Important**  
During UE-V Agent installation or uninstallation, you can either use the AgentSetup.exe file or the AgentSetup&lt;arch&gt;.msi file, but not both. The same file must be used to uninstall the UE-V Agent that was used to install the UE-V Agent.
- Register the UE-V templates for first use. In a PowerShell window, type **register-&lt;TemplateName&gt;** where “TemplateName” is the name of the UE-V template you want to register, and press ENTER.
 
With Windows 10, version 1607 and later, the UE-V service is installed on user devices. Enable the service to start using UE-V. You can enable the service with the Group Policy editor or with Windows PowerShell.
### To Deploy the UE-V Agent
To enable the UE-V service with Group Policy:
You can use the following methods to deploy the UE-V Agent:
1. Open the device’s **Group Policy Editor**.
- An electronic software distribution (ESD) solution system, such as Configuration Manager, that can install a Windows Installer (.msi) file.
2. Navigate to **Computer Configuration** &gt; **Administrative Templates** &gt; **Windows Components** &gt; **Microsoft** **User Experience Virtualization**.
- An installation script that references the Windows Installer (.msi) file that is stored centrally on a share.
3. Run **Enable UEV**.
- An installation program that you run manually on the computer.
4. Restart the device.
Use the following procedure to deploy the UE-V Agent from a network share.
To enable the UE-V service with Windows PowerShell:
**To install and configure the UE-V Agent from a network share**
1. In a PowerShell window, type **Enable-UEV** and press ENTER.
1. Stage the UE-V Agent installation file AgentSetup.exe on a network share to which users have Read permission.
2. Restart the device.
2. Deploy a script to user computers that installs the UE-V Agent. The script should specify the settings storage location.
**Deployment options:** Be sure to use the correct variable format when you install the UE-V Agent. The following table provides examples of deployment options for using the AgentSetup.exe or the Windows Installer (.msi) files.
<table>
<colgroup>
<col width="33%" />
<col width="33%" />
<col width="33%" />
</colgroup>
<thead>
<tr class="header">
<th align="left"><strong>Deployment type</strong></th>
<th align="left"><strong>Deployment description</strong></th>
<th align="left"><strong>Example</strong></th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td align="left"><p>Command prompt</p></td>
<td align="left"><p>When you install the UE-V Agent at a command prompt, use the <em>%^username%</em> variable format. If quotation marks are required because of spaces in the settings storage path, use a batch script file for deployment.</p>
<p></p></td>
<td align="left"><p><code>AgentSetup.exe /quiet /norestart /log &quot;%temp%\UE-VAgentInstaller.log&quot; SettingsStoragePath=\\server\settingsshare\%^username%</code></p>
<p></p>
<p><code>msiexec.exe /i &quot;&lt;path to msi file&gt;&quot; /quiet /norestart /l*v &quot;%temp%\UE-VAgentInstaller.log&quot; SettingsStoragePath=\\server\settingsshare\%^username%</code></p></td>
</tr>
<tr class="even">
<td align="left"><p>Batch script</p></td>
<td align="left"><p>When you install the UE-V Agent from a batch script file, use the <em>%%username%%</em> variable format. If you use this installation method, you must escape the variable with the %% characters. Without this character, the script expands the <em>username</em> variable at installation time, rather than at run time, which causes UE-V to use a single settings storage location for all users.</p></td>
<td align="left"><p><code>AgentSetup.exe /quiet /norestart /log &quot;%temp%\UE-VAgentInstaller.log&quot; SettingsStoragePath=&quot;\\server\settingsshare\%%username%%&quot;</code></p>
<p></p>
<p><code>msiexec.exe /i &quot;&lt;path to msi file&gt;&quot; /quiet /norestart /l*v &quot;%temp%\UE-VAgentInstaller.log&quot; SettingsStoragePath=&quot;\\server\settingsshare\%%username%%&quot;</code></p>
<p></p></td>
</tr>
<tr class="odd">
<td align="left"><p>Windows PowerShell</p></td>
<td align="left"><p>When you install the UE-V Agent from a Windows PowerShell prompt or a Windows PowerShell script, use the <em>%username%</em> variable format.</p></td>
<td align="left"><p><code>&amp; AgentSetup.exe /quiet /norestart /log &quot;%temp%\UE-VAgentInstaller.log&quot; SettingsStoragePath=\\server\settingsshare\%username%</code></p>
<p></p>
<p><code>&amp; msiexec.exe /i &quot;&lt;path to msi file&gt;&quot; /quiet /norestart /l*v &quot;%temp%\UE-VAgentInstaller.log&quot; SettingsStoragePath=\\server\settingsshare\%username%</code></p>
<p></p></td>
</tr>
<tr class="even">
<td align="left"><p>Electronic software distribution, such as deployment of Configuration Manager Software Deployment</p></td>
<td align="left"><p>When you install the UE-V Agent by using Configuration Manager, use the <em>^%username^%</em> variable format.</p></td>
<td align="left"><p><code>AgentSetup.exe /quiet /norestart /log &quot;%temp%\UE-VAgentInstaller.log&quot; SettingsStoragePath=\\server\settingsshare\^%username^%</code></p>
<p></p>
<p><code>msiexec.exe /i &quot;&lt;path to msi file&gt;&quot; /quiet /norestart /l*v &quot;%temp%\UE-VAgentInstaller.log&quot; SettingsStoragePath=\\server\settingsshare\^%username^%</code></p></td>
</tr>
</tbody>
</table>
 
**Note**  
The installation of the UE-V Agent requires administrator rights, and the computer requires a restart before the UE-V Agent can run.
 
### <a href="" id="params"></a>Command-line parameters for UE-V Agent deployment
The command-line parameters of the UE-V Agent are as follows.
<table>
<colgroup>
<col width="33%" />
<col width="33%" />
<col width="33%" />
</colgroup>
<thead>
<tr class="header">
<th align="left"><strong>Command-line parameter</strong></th>
<th align="left"><strong>Definition</strong></th>
<th align="left"><strong>Notes</strong></th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td align="left"><p>/help or /h or /?</p></td>
<td align="left"><p>Displays the AgentSetup.exe usage dialog box.</p></td>
<td align="left"><p></p></td>
</tr>
<tr class="even">
<td align="left"><p>SettingsStoragePath</p></td>
<td align="left"><p>Indicates the Universal Naming Convention (UNC) path that defines where settings are stored.</p></td>
<td align="left"><div class="alert">
<strong>Important</strong>  
<p>You must specify a SettingsStoragePath in UE-V 2.1 and UE-V 2.1 SP1. You can set the AdHomePath string to specify that the user's Active Directory home path is used. For example, <code>SettingsStoragePath = \\share\path|AdHomePath</code>.</p>
<p>In UE-V 2.0, you can leave SettingsStoragePath blank to use the Active Directory home path instead.</p>
</div>
<div>
 
</div>
<p>%username% or %computername% environment variables are accepted. Scripting can require escaped variables.</p>
<p><strong>Default</strong>: &lt;none&gt;</p></td>
</tr>
<tr class="odd">
<td align="left"><p>SettingsStoragePathReg</p></td>
<td align="left"><p>Gets the SettingsStoragePath value from the registry during installation.</p></td>
<td align="left"><p>At the command prompt, type the following example to force UE-V to use the Active Directory home path instead of a specific UNC.</p>
<p><code>msiexec.exe /i AgentSetupx64.msi acceptlicenseterms=true SettingsStoragePathReg=TRUE /quiet /norestart</code></p></td>
</tr>
<tr class="even">
<td align="left"><p>SettingsTemplateCatalogPath</p></td>
<td align="left"><p>Indicates the Universal Naming Convention (UNC) path that defines the location that was checked for new settings location templates.</p></td>
<td align="left"><p>Only required for custom settings location templates</p></td>
</tr>
<tr class="odd">
<td align="left"><p>RegisterMSTemplates</p></td>
<td align="left"><p>Specifies whether the default Microsoft templates should be registered during installation.</p></td>
<td align="left"><p>True | False</p>
<p><strong>Default</strong>: True</p></td>
</tr>
<tr class="even">
<td align="left"><p>SyncMethod</p></td>
<td align="left"><p>Specifies which synchronization method should be used.</p></td>
<td align="left"><p>SyncProvider | None</p>
<p><strong>Default</strong>: SyncProvider</p></td>
</tr>
<tr class="odd">
<td align="left"><p>SyncTimeoutInMilliseconds</p></td>
<td align="left"><p>Specifies the number of milliseconds that the computer waits before time-out when it retrieves user settings from the settings storage location.</p></td>
<td align="left"><p><strong>Default</strong>: 2000 milliseconds</p>
<p>(wait up to 2 seconds)</p></td>
</tr>
<tr class="even">
<td align="left"><p>SyncEnabled</p></td>
<td align="left"><p>Specifies whether UE-V synchronization is enabled or disabled.</p></td>
<td align="left"><p>True | False</p>
<p><strong>Default</strong>: True</p></td>
</tr>
<tr class="odd">
<td align="left"><p>MaxPackageSizeInBytes</p></td>
<td align="left"><p>Specifies a settings package file size in bytes when the UE-V Agent reports that files exceed the threshold.</p></td>
<td align="left"><p>&lt;size&gt;</p>
<p><strong>Default</strong>: none (no warning threshold)</p></td>
</tr>
<tr class="even">
<td align="left"><p>CEIPEnabled</p></td>
<td align="left"><p>Specifies the setting for participation in the Customer Experience Improvement program. If set to <strong>True</strong>, installer information is uploaded to the Microsoft Customer Experience Improvement Program site. If set to <strong>False</strong>, no information is uploaded.</p></td>
<td align="left"><p>True | False</p>
<p><strong>Default</strong>: False</p></td>
</tr>
<tr class="odd">
<td align="left"><p>NoRestart</p></td>
<td align="left"><p>Supports deferral of the restart of the computer after the UE-V Agent is installed.</p></td>
<td align="left"><p></p></td>
</tr>
<tr class="even">
<td align="left"><p>INSTALLFOLDER</p></td>
<td align="left"><p>Enables a different installation folder to be set for the UE-V Agent or UE-V Generator.</p></td>
<td align="left"><p></p></td>
</tr>
<tr class="odd">
<td align="left"><p>MUENABLED</p></td>
<td align="left"><p>Enables Setup to accept the option to be included in the Microsoft Update program.</p></td>
<td align="left"><p></p></td>
</tr>
<tr class="even">
<td align="left"><p>ACCEPTLICENSETERMS</p></td>
<td align="left"><p>Lets UE-V be installed silently. This must be set to <strong>True</strong> to install UE-V silently and bypass the requirement that the user accepts the UE-V license terms. If set to <strong>False</strong> or left empty, the user receives an error message and UE-V is not installed.</p></td>
<td align="left"><div class="alert">
<strong>Important</strong>  
<p>This parameter is required to install UE-V silently.</p>
</div>
<div>
 
</div></td>
</tr>
<tr class="odd">
<td align="left"><p>NORESTART</p></td>
<td align="left"><p>Prevents a mandatory restart after the UE-V Agent is installed.</p></td>
<td align="left"><p></p></td>
</tr>
</tbody>
</table>
 
### Update the UE-V Agent
Updates for the UE-V Agent software are provided through Microsoft Update. You can deploy UE-V Agent updates by using Enterprise Software Distribution (ESD) infrastructure systems.
During a UE-V Agent upgrade, the default group of settings location templates for common Microsoft applications and Windows settings can be updated.
### Upgrade the UE-V 2.x Agent
The UE-V 2.x Agent introduces many new features and modifies how and when the agent uploads content to the settings storage share. The upgrade process automates these changes. To upgrade the UE-V Agent, run the UE-V Agent install package (AgentSetup.exe, AgentSetupx86.msi, or AgentSetupx64.msi) on users’ computers.
**Note**  
When you upgrade the UE-V Agent, you must use the same installer type (.exe file or .msi packet) that installed the previous UE-V Agent. For example, use the UE-V 2 AgentSetup.exe to upgrade UE-V 1.0 Agents that were installed by using AgentSetup.exe.
 
The following configurations are preserved when the Agent Setup program runs:
- Settings storage path
- Registry settings
- Scheduled tasks (Interval settings are reset to their defaults)
**Note**  
A computer with UE-V 2.x settings location templates that are registered in the UE-V 1.0 Agent register errors in the Windows Event Log.
 
You can use Microsoft System Center 2012 Configuration Manager or another enterprise software distribution tool to automate and distribute the UE-V Agent upgrade.
**Recommendations:** We recommend that you upgrade all of the UE-V 1.0 Agents in a computing environment, but it is not required. UE-V 2.x settings location templates can interact with a UE-V 1.0 Agent because they only share the settings from the settings storage path. We recommend, however, that you move the deployments to a single agent version to simplify management and to support UE-V.
### Repair the UE-V Agent after an unsuccessful upgrade
You might experience errors after you attempt one of the following operations:
- Upgrade from UE-V 1.0 to UE-V 2
- Upgrade to a newer version of Windows, for example, from Windows 7 to Windows 8 or from Windows 8 to Windows 8.1.
- Uninstall the agent after upgrading the UE-V Agent
To resolve any issues, attempt to repair the UE-V Agent by entering this command at a command prompt on the computer where the agent is installed.
``` syntax
msiexec.exe /f "<path to msi file>" /quiet /norestart /l*v "%temp%\UE-VAgentInstaller.log
```
You can then retry the uninstall process or upgrade by installing the newer version of the UE-V Agent.
3. In a PowerShell window, type **Get-UEVStatus** and press ENTER to verify that the UE-V service was successfully enabled.
## Have a suggestion for UE-V?
Add or vote on suggestions [here](http://uev.uservoice.com/forums/280428-microsoft-user-experience-virtualization). For UE-V issues, use the [UE-V TechNet Forum](https://social.technet.microsoft.com/Forums/en-us/home?forum=mdopuev&filter=alltypes&sort=lastpostdesc).
Add or vote on suggestions [here](http://uev.uservoice.com/forums/280428-microsoft-user-experience-virtualization). For UE-V issues, use the [UE-V TechNet Forum](https://social.technet.microsoft.com/forums/home?forum=mdopuev).
## Related topics
[Prepare a UE-V Deployment](uev-prepare-for-deployment.md)
[Prepare a UE-V 2.x Deployment](uev-prepare-for-deployment.md)
[Deploy UE-V 2.x for Custom Applications](uev-deploy-uev-for-custom-applications.md)
 
 
[Use UE-V with custom applications](uev-deploy-uev-for-custom-applications.md)

282
windows/manage/uev-deploy-uev-for-custom-applications.md
View File

@ -1,6 +1,6 @@
---
title: Deploy UE-V for Custom Applications
description: Deploy UE-V for Custom Applications
title: Use UE-V with custom applications
description: Use UE-V with custom applications
author: jamiejdt
ms.pagetype: mdop, virtualization
ms.mktglfcycl: deploy
@ -8,49 +8,47 @@ ms.sitesec: library
ms.prod: w10
---
# Use UE-V with custom applications
# Deploy UE-V for Custom Applications
User Experience Virtualization (UE-V) uses XML files called **settings location templates** to monitor and synchronize desktop application settings and Windows desktop settings between user devices. By default, some settings location templates are included in UE-V. However, if you want to synchronize settings for desktop applications other than those included in the default templates, you can create your own custom settings location templates with the UE-V template generator.
After you’ve reviewed
- [Prepare a UE-V Deployment](uev-prepare-for-deployment.md) and decided that you want to synchronize settings for custom applications (third-party, line-of-business, e.g.), you’ll need to deploy the features of UE-V described in this topic.
Microsoft User Experience Virtualization (UE-V) uses XML files called **settings location templates** to monitor and synchronize desktop application settings and Windows desktop settings between user computers. By default, some settings location templates are included in UE-V. But if you want to synchronize settings for desktop applications other than those included in the default templates, you can create your own custom settings location templates by using the UE-V Generator.
To start, here are the main steps required to synchronize settings for custom applications:
Once you have read through the planning material in [Prepare a UE-V Deployment](uev-prepare-for-deployment.md) and have decided that you want to synchronize settings for custom applications (third-party, line-of-business, etc.), you will deploy the features of UE-V as described in this topic. To start, here are the main steps required to synchronize settings for custom applications:
- [Install the UE-V template generator](uev-deploy-uev-for-custom-applications.md#uevgen)
- [Install the UEV Generator](#uevgen)
Use the UEV template generator to create custom XML settings location templates.
Use the UEV Generator to create custom XML settings location templates.
- [Configure a UE-V settings template catalog](#deploycatalogue)
- [Configure a UE-V settings template catalog](#deploy-a-settings-template-catalog)
You can define this path where custom settings location templates are stored.
- [Create custom settings location templates](#createcustomtemplates)
- [Create custom settings location templates](#create-custom-settings-location-templates)
These custom templates let users sync settings for custom applications.
- [Deploy the custom settings location templates](#deploycustomtemplates)
- [Deploy the custom settings location templates](#deploy-the-custom-settings-location-templates)
After you test the custom template to ensure that settings are synced correctly, you can deploy these templates in one of these ways:
- Through your existing deployment infrastructure, such as Configuration Manager
- With your existing electronic software distribution solution, such as Configuration Manager
- By using Group Policy preferences
- With Group Policy preferences
- [Deploy a UE-V settings template catalog](#deploycatalogue)
- With a UE-V settings template catalog
**Note**  
Templates that are deployed by using ESD or Group Policy must be registered with UE-V Windows Management Instrumentation (WMI) or Windows PowerShell.
**Note**
Templates that are deployed with electronic software distribution methods or Group Policy must be registered with UE-V Windows Management Instrumentation (WMI) or Windows PowerShell.
 
## Prepare to deploy UE-V for custom applications
## Prepare to Deploy UE-V for Custom Applications
Before you start deploying the UE-V features that handle custom applications, review the following important information.
### The UE-V template generator
Before you start deploying the UE-V features that handle custom applications, there are just a couple things to review.
### The UE-V Generator
The UE-V Generator monitors an application to discover and capture the locations where the application stores its settings. The application that is monitored must be a traditional application. You use the UE-V Generator to create settings location templates, but it cannot create a settings location template from these application types:
The UE-V template generator monitors Win32 applications to discover and capture the locations where the application stores its settings. The application that is monitored must be a traditional application. You use the UE-V template generator to create settings location templates, but it cannot create a settings location template from these application types:
- Virtualized applications
@ -58,12 +56,10 @@ The UE-V Generator monitors an application to discover and capture the locations
- Java applications
- Windows apps
- Windows applications
**Note**  
UE-V settings location templates cannot be created from virtualized applications or Terminal Services applications. However, settings that are synchronized by using the templates can be applied to those applications. To create templates that support Virtual Desktop Infrastructure (VDI) and Terminal Services applications, open a version of the Windows Installer (.msi) package of the application by using the UE-V Generator. For more information about synchronizing settings for virtual applications, see [Using UE-V with Application Virtualization Applications](uev-using-uev-with-application-virtualization-applications.md).
 
**Note**
UE-V settings location templates cannot be created from virtualized applications or Terminal Services applications. However, settings that are synchronized by using the templates can be applied to those applications. To create templates that support Virtual Desktop Infrastructure (VDI) and Terminal Services applications, open a version of the Windows Installer (.msi) package of the application by using the UE-V template generator. For more information about synchronizing settings for virtual applications, see [Using UE-V with virtual applications](uev-using-uev-with-application-virtualization-applications.md).
**Excluded Locations:** The discovery process excludes locations that commonly store application software files that do not synchronize settings well between user computers or computing environments. By default, these are excluded:
@ -83,179 +79,121 @@ If registry keys and files that are stored in excluded locations are required to
### Replace the default Microsoft templates
The UE-V Agent installs a default group of settings location templates for common Microsoft applications and Windows settings. If you customize these templates, or create settings location templates to synchronize settings for custom applications, the UE-V Agent can be configured to use a settings template catalog to store the templates. In this case, you will need to include the default templates along with the custom templates in the settings template catalog.
The UE-V service installs a default group of settings location templates for common Microsoft applications and Windows settings. If you customize these templates, or create settings location templates to synchronize settings for custom applications, the UE-V service can be configured to use a settings template catalog to store the templates. In this case, you will need to include the default templates along with the custom templates in the settings template catalog.
When you [Deploy a UE-V Agent](http://technet.microsoft.com/library/dn458891.aspx#agent), you can use the command-line parameter `RegisterMSTemplates` to disable the registration of the default Microsoft templates.
<!-- ALL OF THE FOLLOWING PARAGRAPHS NEED TO BE COMMENTED ON BY TOMMY - RE AGENT AND PARAMETERS.
When you [Enable the UE-V service](#enable-the-ue-v-service), you can use the command-line parameter RegisterMStemplates to disable the registration of the default Microsoft templates.
When you use Group Policy to configure the settings template catalog path, you can choose to replace the default Microsoft templates. If you configure the policy settings to replace the default Microsoft templates, all of the default Microsoft templates that are installed by the UE-V Agent are deleted and only the templates that are located in the settings template catalog are used. The UE-V Agent configuration setting parameter `RegisterMSTemplates` must be set to *true* in order to override the default Microsoft template.
When you use Group Policy to configure the settings template catalog path, you can choose to replace the default Microsoft templates. If you configure the policy settings to replace the default Microsoft templates, all of the default Microsoft templates that are installed by the UE-V Agent are deleted and only the templates that are located in the settings template catalog are used. The UE-V Agent configuration setting parameter RegisterMStemplates must be set to true in order to override the default Microsoft template.
**Note**  
**Note**
If you disable this policy setting after it has been enabled, the UE-V Agent does not restore the default Microsoft templates.
 
If there are customized templates in the settings template catalog that use the same ID as the default Microsoft templates, and the UE-V Agent is not configured to replace the default Microsoft templates, the Microsoft templates are ignored.
You can also replace the default templates by using the UE-V Windows PowerShell features. To replace the default Microsoft template with Windows PowerShell, unregister all of the default Microsoft templates, and then register the customized templates.
**Note**  
**Note**
Old settings packages remain in the settings storage location even if you deploy new settings location templates for an application. These packages are not read by the agent, but neither are they automatically deleted.
-->
 
### Install the UEV template generator
## <a href="" id="uevgen"></a>Install the UEV 2.x Generator
Use the UE-V template generator to create custom settings location templates that you can then distribute to user devices. You can also edit an existing template or validate a template that was created by using another XML editor with the template generator.
The UE-V template generator is included in the Windows Assessment and Deployment Kit (ADK) for Windows 10.
Install the Microsoft User Experience Virtualization (UE-V) 2.0 Generator on a computer that you can then use to create a custom settings location template. This computer should have the applications installed for which custom settings location templates are to be generated.
Install the UE-V template generator on a computer that you can use to create a custom settings location template. This computer should have the applications installed for which custom settings location templates need to be generated.
**To install the UE-V Generator**
Important: UE-V for Windows 10, version 1607 includes a new template generator. If you are upgrading from an existing UE-V installation, you’ll need to use the new generator to create settings location templates. Templates created with previous versions of the UE-V template generator will still work.
1. As a user with local administrator rights, locate the UE-V Generator installation file **ToolSetup.exe** provided with the UE-V software. Or, if you know the computer architecture, you can run the appropriate Windows Installer (.msi) file, **ToolsSetupx64.msi** or **ToolsSetupx86.msi**.
**To install the UE-V template generator:**
2. Double-click the installation file. The User Experience Virtualization Generator Setup wizard opens. Click **Next** to continue.
To install the UE-V template generator:
3. Accept the Microsoft Software License Terms, and then click **Next**.
1. Go to [Download the Windows ADK](https://developer.microsoft.com/en-us/windows/hardware/windows-assessment-deployment-kit) to access the ADK.
4. Click the options for Microsoft Updates and the Customer Experience Improvement Program.
2. Click or press the **Get Windows ADK for Windows 10** button on this page to start the ADK installer. On the screen pictured below, select **Microsoft User Experience Virtualization (UE-V) Template Generator** and then click or press Install.
5. Select the destination folder in which to install the UE-V Generator, and then click **Next**.
<!-- PRESERVING ORIGINAL IMAGE CODING JUST IN CASE
<img src="media/image1.png" width="537" height="394" />
-->
6. Click **Install** to begin the installation.
![Selecting UE-V features in ADK](images/uev-adk-select-uev-feature.png)
**Note**  
A prompt for **User Account Control** appears before the application is installed. Permission is required to install the UE-V Generator.
3. To open the generator, select **Microsoft Application Virtualization Generator** from the **Start** menu.
 
<!--
Link to <https://technet.microsoft.com/en-us/itpro/mdop/uev-v2/working-with-custom-ue-v-2x-templates-and-the-ue-v-2x-generator-new-uevv2>
AKA
[Working with Custom UE-V Templates and the UE-V Generator](uev-working-with-custom-templates-and-the-uev-generator.md)
-->
7. Click **Finish** to close the wizard after the installation is finished. You must restart your computer before you can run the UE-V Generator.
To verify that the installation was successful, click **Start** &gt; **All Programs** &gt; **Microsoft User Experience Virtualization** &gt; **Microsoft User Experience Virtualization template generator**.
To verify that the installation was successful, click **Start**, click **All Programs**, click **Microsoft User Experience Virtualization**, and then click **Microsoft User Experience Virtualization Generator**.
### Deploy a settings template catalog
**Note**  
The UE-V 2 Generator can only be used to create templates for UE-V 2 Agents. In a mixed deployment of UE-V 1.0 Agents and UE-V 2 Agents, you should continue to use the UE-V 1.0 Generator until you have upgraded all UE-V Agents.
The UE-V settings template catalog is a folder path on UE-V computers or a Server Message Block (SMB) network share that stores all the custom settings location templates. The UE-V service checks this location one time each day and updates its synchronization behavior, based on the templates in this folder.
 
The UE-V service checks this folder for templates that were added, updated, or removed. It registers new and changed templates and unregisters removed templates. By default, templates are registered and unregistered one time per day at 3:30 A.M. local time by the Task Scheduler and at system startup. To customize the frequency of this scheduled task, see [Changing the frequency of UE-V scheduled tasks](uev-changing-the-frequency-of-scheduled-tasks.md).
## <a href="" id="deploycatalogue"></a>Deploy a Settings Template Catalog
You can configure the settings template catalog path with command-line options, Group Policy, WMI, or Windows PowerShell. Templates stored at the settings template catalog path are automatically registered and unregistered by a scheduled task.
The User Experience Virtualization settings template catalog is a folder path on UE-V computers or a Server Message Block (SMB) network share that stores all the custom settings location templates. A scheduled task in the UE-V Agent checks this location one time each day and updates its synchronization behavior, based on the templates in this folder.
The UE-V Agent registers templates that were added or updated in this folder after the last time that the folder was checked and unregisters templates that are removed. By default, templates are registered and unregistered one time per day at 3:30 A.M. local time by the Task Scheduler and at system startup. To customize the frequency of this scheduled task, see [Changing the Frequency of UE-V Scheduled Tasks](uev-changing-the-frequency-of-scheduled-tasks.md).
You can configure the settings template catalog path by using the installation command-line options, Group Policy, WMI, or Windows PowerShell. Templates that are stored at the settings template catalog path are automatically registered and unregistered by a scheduled task.
**To configure the settings template catalog for UE-V**
**To configure the settings template catalog for UE-V:**
1. Create a new folder on the computer that stores the UE-V settings template catalog.
2. Set the following share-level (SMB) permissions for the settings template catalog folder.
<table>
<colgroup>
<col width="50%" />
<col width="50%" />
</colgroup>
<thead>
<tr class="header">
<th align="left"><strong>User account</strong></th>
<th align="left"><strong>Recommended permissions</strong></th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td align="left"><p>Everyone</p></td>
<td align="left"><p>No Permissions</p></td>
</tr>
<tr class="even">
<td align="left"><p>Domain Computers</p></td>
<td align="left"><p>Read Permission Levels</p></td>
</tr>
<tr class="odd">
<td align="left"><p>Administrators</p></td>
<td align="left"><p>Read/Write Permission Levels</p></td>
</tr>
</tbody>
</table>
| **User account** | **Recommended permissions** |
|------------------|------------------------------|
| Everyone | No Permissions |
| Domain Computers | Read Permission Levels |
| Administrators | Read/Write Permission Levels |
 
1. Set the following NTFS file system permissions for the settings template catalog folder.
3. Set the following NTFS file system permissions for the settings template catalog folder.
| **User account** | **Recommended permissions** | **Apply to** |
|------------------|-------------------------------|-----------------------------------|
| Creator/Owner | Full Control | This Folder, Subfolders and Files |
| Domain Computers | List Folder Contents and Read | This Folder, Subfolders and Files |
| Everyone | No Permissions | No Permissions |
| Administrators | Full Control | This Folder, Subfolders and Files |
<table>
<colgroup>
<col width="33%" />
<col width="33%" />
<col width="33%" />
</colgroup>
<thead>
<tr class="header">
<th align="left">User account</th>
<th align="left">Recommended permissions</th>
<th align="left">Apply to</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td align="left"><p>Creator/Owner</p></td>
<td align="left"><p>Full Control</p></td>
<td align="left"><p>This Folder, Subfolders and Files</p></td>
</tr>
<tr class="even">
<td align="left"><p>Domain Computers</p></td>
<td align="left"><p>List Folder Contents and Read</p></td>
<td align="left"><p>This Folder, Subfolders and Files</p></td>
</tr>
<tr class="odd">
<td align="left"><p>Everyone</p></td>
<td align="left"><p>No Permissions</p></td>
<td align="left"><p>No Permissions</p></td>
</tr>
<tr class="even">
<td align="left"><p>Administrators</p></td>
<td align="left"><p>Full Control</p></td>
<td align="left"><p>This Folder, Subfolders and Files</p></td>
</tr>
</tbody>
</table>
 
4. Click **OK** to close the dialog boxes.
1. Click **OK** to close the dialog boxes.
At a minimum, the network share must grant permissions for the Domain Computers group. In addition, grant access permissions for the network share folder to administrators who are to manage the stored templates.
## <a href="" id="createcustomtemplates"></a>Create Custom Settings Location Templates
### Create custom settings location templates
Use the UE-V template generator to create settings location templates for line-of-business applications or other custom applications. After you create the template for an application, deploy it to computers to synchronize settings for that application.
Use the UE-V Generator to create settings location templates for line-of-business applications or other custom applications. After the template for an application is created, you can deploy it to computers so that settings are synchronized for that application.
**To create a UE-V settings location template with the UE-V template generator:**
**To create a UE-V settings location template with the UE-V Generator**
1. Click **Start**, click **All Programs**, click **Microsoft User Experience Virtualization**, and then click **Microsoft User Experience Virtualization Generator**.
1. Click **Start** &gt; **All Programs** &gt; **Microsoft User Experience Virtualization** &gt; **Microsoft User Experience Virtualization template generator**.
2. Click **Create a settings location template**.
3. Specify the application. Browse to the file path of the application (.exe) or the application shortcut (.lnk) for which you want to create a settings location template. Specify the command-line arguments, if any, and working directory, if any. Click **Next** to continue.
3. Specify the application. Browse to the file path of the application (.exe) or the application shortcut (.lnk) for which you want to create a settings location template. Specify the command-line arguments, if any, and working directory, if any.
**Note**  
Before the application is started, the system displays a prompt for **User Account Control**. Permission is required to monitor the registry and file locations that the application uses to store settings.
4. Click **Next** to continue.
 
**Note**
Before the application is started, the system displays a prompt for **User Account Control**. Permission is required to monitor the registry and file locations that the application uses to store settings.
4. After the application starts, close the application. The UE-V Generator records the locations where the application stores its settings.
1. After the application starts, close the application. The UE-V template generator records the locations where the application stores its settings.
5. After the process is completed, click **Next** to continue.
2. After the process is completed, click **Next** to continue.
6. Review and select the check boxes that are next to the appropriate registry settings locations and settings file locations to synchronize for this application. The list includes the following two categories for settings locations:
3. Review and select the appropriate registry settings locations and settings file locations to synchronize for this application. The list includes the following two categories for settings locations:
- **Standard**: Application settings that are stored in the registry under the HKEY\_CURRENT\_USER keys or in the file folders under \\ **Users** \\ \[User name\] \\ **AppData** \\ **Roaming**. The UE-V Generator includes these settings by default.
- **Standard**: Application settings that are stored in the registry under the HKEY\_CURRENT\_USER keys or in the file folders under \\ **Users** \\ \[User name\] \\ **AppData** \\ **Roaming**. The UE-V template generator includes these settings by default.
- **Nonstandard**: Application settings that are stored outside the locations are specified in the best practices for settings data storage (optional). These include files and folders under **Users** \\ \[User name\] \\ **AppData** \\ **Local**. Review these locations to determine whether to include them in the settings location template. Select the locations check boxes to include them.
Click **Next** to continue.
4. Click **Next** to continue.
7. Review and edit any **Properties**, **Registry** locations, and **Files** locations for the settings location template.
5. Review and edit any **Properties**, **Registry** locations, and **Files** locations for the settings location template.
- Edit the following properties on the **Properties** tab:
@ -267,72 +205,56 @@ Use the UE-V Generator to create settings location templates for line-of-busines
- **File version**: The file version number of the .exe file of the application. This property, in conjunction with the **Product version**, helps determine which applications are targeted by the settings location template. This property accepts a major version number. If this property is empty, the settings location template applies to all versions of the program.
- **Template author name** (optional): The name of the settings location template author.
- **template author name** (optional): The name of the settings location template author.
- **Template author email** (optional): The email address of the settings location template author.
- **template author email** (optional): The email address of the settings location template author.
- The **Registry** tab lists the **Key** and **Scope** of the registry locations that are included in the settings location template. Edit the registry locations by using the **Tasks** drop-down menu. Tasks enable you to add new keys, edit the name or scope of existing keys, delete keys, and browse the registry where the keys are located. Use the **All Settings** scope to include all the registry settings under the specified key. Use the **All Settings and Subkeys** to include all the registry settings under the specified key, subkeys, and subkey settings.
- The **Files** tab lists the file path and file mask of the file locations that are included in the settings location template. Edit the file locations by use of the **Tasks** drop-down menu. Tasks for file locations enable you to add new files or folder locations, edit the scope of existing files or folders, delete files or folders, and open the selected location in Windows Explorer. Leave the file mask empty to include all files in the specified folder.
8. Click **Create**, and then click **Save** to save the settings location template on the computer.
6. Click **Create**, and then click **Save** to save the settings location template on the computer.
9. Click **Close** to close the Settings Template Wizard. Exit the UE-V Generator application.
7. Click **Close** to close the settings template wizard. Exit the UE-V template generator application.
After you have created the settings location template for an application, you should test the template. Deploy the template in a lab environment before you put it into production in the enterprise.
After you have created the settings location template for an application, test the template. Deploy the template in a lab environment before you put it into production in the enterprise.
[Application Template Schema Reference for UE-V](http://technet.microsoft.com/library/dn763947.aspx) details the XML structure of the UE-V settings location template and provides guidance for editing these files.
See [Application template schema reference for UE-V](uev-application-template-schema-reference.md) for details about the XML structure of the UE-V settings location template and for guidance about editing these files.
## <a href="" id="deploycustomtemplates"></a>Deploy the Custom Settings Location Templates
### Deploy the Custom Settings Location templates
After you create a settings location template with the UE-V template generator, you should test it to ensure that the application settings are synchronized correctly. You can then safely deploy the settings location template to computers in the enterprise.
After you create a settings location template with the UE-V Generator, you should test it to ensure that the application settings are synchronized correctly. You can then safely deploy the settings location template to computers in the enterprise.
You can deploy settings location templates using of these methods:
Settings location templates can be deployed by using one of these methods:
- An enterprise software distribution (ESD) system such as System Center Configuration Manager
- An electronic software distribution (ESD) system such as System Center Configuration Manager
- Group Policy preferences
- A UE-V settings template catalog
Templates that are deployed by using an ESD system or Group Policy Objects must be registered through UE-V Windows Management Instrumentation (WMI) or Windows PowerShell. Templates that are stored in the settings template catalog location are automatically registered by the UE-V Agent.
Templates that are deployed by using an ESD system or Group Policy objects must be registered using UE-V Windows Management Instrumentation (WMI) or Windows PowerShell. Templates that are stored in the settings template catalog location are automatically registered by the UE-V service.
**To use the settings template catalog path to deploy UE-V settings location templates**
**To deploy UE-V settings location templates with a settings template catalog path:**
1. Browse to the network share folder that is defined as the settings template catalog.
1. Browse to the network share folder that you defined as the settings template catalog.
2. Add, remove, or update settings location templates in the settings template catalog to reflect the UE-V Agent template configuration that you want for UE-V computers.
2. Add, remove, or update settings location templates in the settings template catalog to reflect the UE-V service template configuration that you want for UE-V computers.
**Note**  
**Note**
Templates on computers are updated daily. The update is based on changes to the settings template catalog.
 
3. To manually update templates on a computer that runs the UE-V service, open an elevated command prompt, and browse to **%Program Files%\\Microsoft User Experience Virtualization \\ Agent \\ &lt;x86 or x64 &gt;**, and then run **ApplySettingstemplateCatalog.exe**.
3. To manually update templates on a computer that runs the UE-V Agent, open an elevated command prompt, and browse to **%Program Files%\\Microsoft User Experience Virtualization \\ Agent \\ &lt;x86 or x64 &gt;**, and then run **ApplySettingsTemplateCatalog.exe**.
**Note**  
**Note**
This program runs automatically during computer startup and daily at 3:30 A. M. to gather any new templates that were recently added to the catalog.
 
## Have a suggestion for UE-V?
Add or vote on suggestions [here](http://uev.uservoice.com/forums/280428-microsoft-user-experience-virtualization). For UE-V issues, use the [UE-V TechNet Forum](https://social.technet.microsoft.com/Forums/en-us/home?forum=mdopuev&filter=alltypes&sort=lastpostdesc).
## Related topics
- [Prepare a UE-V Deployment](uev-prepare-for-deployment.md)
[Prepare a UE-V Deployment](uev-prepare-for-deployment.md)
[Deploy Required Features for UE-V](uev-deploy-required-features.md)
 
 
- [Deploy Required UE-V Features](uev-deploy-required-features.md)

22
windows/manage/uev-for-windows.md
View File

@ -1,6 +1,6 @@
---
title: Microsoft User Experience Virtualization for Windows 10, version 1607
description: Overview of Microsoft User Experience Virtualization for Windows 10, version 1607
title: User Experience Virtualization for Windows 10, version 1607
description: Overview of User Experience Virtualization for Windows 10, version 1607
author: jamiejdt
ms.pagetype: mdop, virtualization
ms.mktglfcycl: deploy
@ -8,9 +8,9 @@ ms.sitesec: library
ms.prod: w10
---
# Microsoft User Experience Virtualization for Windows 10, version 1607
# User Experience Virtualization for Windows 10, version 1607
Many users customize their settings for Windows and for specific applications. Customizable Windows settings include Windows Store appearance, language, background picture, font size, and accent colors. Customizable application settings include language, appearance, behavior, and user interface options. With Microsoft User Experience Virtualization (UE-V), you can capture user-customized Windows and application settings and store them on a centrally managed network file share. When users log on, their personalized settings are applied to their work session, regardless of which device or virtual desktop infrastructure (VDI) sessions they log on to.
Many users customize their settings for Windows and for specific applications. Customizable Windows settings include Windows Store appearance, language, background picture, font size, and accent colors. Customizable application settings include language, appearance, behavior, and user interface options. With User Experience Virtualization (UE-V), you can capture user-customized Windows and application settings and store them on a centrally managed network file share. When users log on, their personalized settings are applied to their work session, regardless of which device or virtual desktop infrastructure (VDI) sessions they log on to.
**With UE-V you can…**
@ -49,7 +49,11 @@ Use these UE-V components to create and manage custom templates for your third-p
| **UE-V Generator** | Use the **UE-V generator** to create custom settings location templates that you can then distribute to user computers. The UE-V generator also lets you edit an existing template or validate a template that was created with a different XML editor. <br>With the Windows 10, version 1607 release, the UE-V generator is installed with the [Windows 10 Assessment and Deployment kit](https://developer.microsoft.com/en-us/windows/hardware/windows-assessment-deployment-kit) (Windows ADK). <br>If you are upgrading from an existing UE-V installation, you’ll need to use the new generator to create new settings location templates. Application templates created with previous versions of the UE-V generator are still supported, however. |
| **Settings template catalog** | The **settings template catalog** is a folder path on UE-V computers or a Server Message Block (SMB) network share that stores the custom settings location templates. The UE-V service checks this location once a day, retrieves new or updated templates, and updates its synchronization behavior.<br>If you use only the UE-V default settings location templates, then a settings template catalog is unnecessary. For more information about settings deployment catalogs, see [Deploy a UE-V settings template catalog](uev-deploy-uev-for-custom-applications.md#deploycatalogue). |
<!-- PRESERVING ORIGINAL IMAGE CODING JUST IN CASE
<img src="media/image2.gif" width="595" height="330" />
-->
![UE-V Generator process](images/uev-generator-process.gif)
## Settings Synchronized by Default
@ -68,18 +72,12 @@ UE-V synchronizes settings for these applications by default. For a complete lis
**Note**
You can also [customize UE-V to synchronize settings](uev-deploy-uev-for-custom-applications.md) for applications other than those synchronized by default.
## UE-V for Windows 10, version 1607 Release Notes
**Upgrade from UE-V 1.0 to the in-box version of UE-V is not supported**
Client side caching technology (CSC) used in UE-V 1.0, used for pinning the UE-V sync folder, was removed in UE-V 2.x. As a result, upgrading to UE-V 1.0 to UE-V 2.x or the in-box version of UE-V, released with Windows 10, version 1607, is not supported.
To work around this issue, unpin the CSC UE-V 1.0 sync folder and then upgrade to the in-box version of UE-V, released in Windows 10, version 1607.
## Other resources for this feature
- [Get Started with UE-V](uev-getting-started.md)
- [UE-V Release Notes](uev-release-notes-1607.md)
- [Prepare a UE-V Deployment](uev-prepare-for-deployment.md)
- [Administer UE-V](uev-administering-uev.md)

276
windows/manage/uev-getting-started.md
View File

@ -1,6 +1,6 @@
---
title: Get Started with UE-V 2.x
description: Get Started with UE-V 2.x
title: Get Started with UE-V
description: Get Started with UE-V
author: jamiejdt
ms.pagetype: mdop, virtualization
ms.mktglfcycl: deploy
@ -8,103 +8,43 @@ ms.sitesec: library
ms.prod: w10
---
# Get Started with UE-V
# Get Started with UE-V 2.x
Applies to: Windows 10, version 1607
Follow the steps in this topic to deploy Microsoft User Experience Virtualization (UE-V) in a test environment. Evaluate UE-V to determine whether it’s the right solution to manage user settings across multiple devices within your enterprise.
**Note**
The information in this section is explained in greater detail throughout the rest of the documentation. If you’ve already determined that UE-V is the right solution and you don’t need to further evaluate it, go to Prepare a UE-V deployment.
The standard installation of UE-V synchronizes the default Microsoft Windows and Office settings and many Windows applications settings. For best results, ensure that your test environment includes two or more user computers that share network access.
- [Step 1: Confirm prerequisites](#step-1-confirm-prerequisites). Review the supported configurations in this section to verify that your environment is able to run UE-V.
- [Step 2: Deploy the settings storage location](#step-2-deploy-the-settings-storage-location). Explains how to deploy a settings storage location. All UE-V deployments require a location to store settings packages that contain the synchronized setting values.
- [Step 3: Enable the UE-V service](#step-3-enable-the-UE-V-service-on-user-devices). Explains how to enable to UE-V service on user devices. To synchronize settings using UE-V, devices must have the UE-V service enabled and running.
- [Step 4: Test Your UE-V evaluation deployment](#step-4-test-your-UE-V-evaluation-deployment). Run a few tests on two computers with the UE-V service enabled to see how UE-V works and if it meets your organization’s needs.
- Step 5: Deploy UE-V for custom applications (optional). If you want to evaluate how your third-party and line-of-business applications work with UE-V, follow the steps in [Use UE-V with custom applications](uev-deploy-uev-for-custom-applications.md). Following this link takes you to another topic. Use your browser’s **Back** button to return to this topic.
## Step 1: Confirm prerequisites
Before you proceed, ensure that your environment meets the following requirements for running UE-V.
| **Operating system** | **Edition** | **Service pack** | **System architecture** | **Windows PowerShell** | **Microsoft .NET Framework** |
|-------------------------|-------------|------------------|-------------------------|---------------------------------|------------------------------|
| Windows 10, version 1607 | ??? | NA | 32-bit or 64-bit | Windows PowerShell 3.0 or higher | ???? |
| Windows 7 | Ultimate, Enterprise, or Professional Edition | SP1 | 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 | SP1 | 64-bit | Windows PowerShell 3.0 or higher | .NET Framework 4 or higher |
| Windows 8 and Windows 8.1 | Enterprise or Pro | None | 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 | None | 64-bit | Windows PowerShell 3.0 or higher | .NET Framework 4.5 |
## Step 2: Deploy the settings storage location
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.
**Note**  
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](uev-prepare-for-deployment.md).
 
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.
- [Step 1: Confirm Prerequisites](#step1): Make sure your environment is able to run UE-V, including details about supported configurations.
- [Step 2: Deploy the Settings Storage Location for UE-V 2](#step2): All UE-V deployments require a location for settings packages that contain the synchronized setting values.
- [Step 3: Deploy the UE-V 2 Agent](#step3): To synchronize settings using UE-V, devices must have the UE-V Agent installed and running.
- [Step 4: Test Your UE-V 2 Evaluation Deployment](#step4): Run a few tests on two computers that have the UE-V Agent installed and see how UE-V works.
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](uev-deploy-uev-for-custom-applications.md).
## <a href="" id="step1"></a>Step 1: Confirm Prerequisites
Before you proceed, make sure your environment includes these requirements for running UE-V.
<table style="width:100%;">
<colgroup>
<col width="16%" />
<col width="16%" />
<col width="16%" />
<col width="16%" />
<col width="16%" />
<col width="16%" />
</colgroup>
<thead>
<tr class="header">
<th align="left"><strong>Operating system</strong></th>
<th align="left"><strong>Edition</strong></th>
<th align="left"><strong>Service pack</strong></th>
<th align="left"><strong>System architecture</strong></th>
<th align="left"><strong>Windows PowerShell</strong></th>
<th align="left"><strong>Microsoft .NET Framework</strong></th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td align="left"><p>Windows 7</p></td>
<td align="left"><p>Ultimate, Enterprise, or Professional Edition</p></td>
<td align="left"><p>SP1</p></td>
<td align="left"><p>32-bit or 64-bit</p></td>
<td align="left"><p>Windows PowerShell 3.0 or higher</p></td>
<td align="left"><p>.NET Framework 4 or higher</p></td>
</tr>
<tr class="even">
<td align="left"><p>Windows Server 2008 R2</p></td>
<td align="left"><p>Standard, Enterprise, Datacenter, or Web Server</p></td>
<td align="left"><p>SP1</p></td>
<td align="left"><p>64-bit</p></td>
<td align="left"><p>Windows PowerShell 3.0 or higher</p></td>
<td align="left"><p>.NET Framework 4 or higher</p></td>
</tr>
<tr class="odd">
<td align="left"><p>Windows 8 and Windows 8.1</p></td>
<td align="left"><p>Enterprise or Pro</p></td>
<td align="left"><p>None</p></td>
<td align="left"><p>32-bit or 64-bit</p></td>
<td align="left"><p>Windows PowerShell 3.0 or higher</p></td>
<td align="left"><p>.NET Framework 4.5</p></td>
</tr>
<tr class="even">
<td align="left"><p>Windows Server 2012 or Windows Server 2012 R2</p></td>
<td align="left"><p>Standard or Datacenter</p></td>
<td align="left"><p>None</p></td>
<td align="left"><p>64-bit</p></td>
<td align="left"><p>Windows PowerShell 3.0 or higher</p></td>
<td align="left"><p>.NET Framework 4.5</p></td>
</tr>
</tbody>
</table>
 
Also…
- **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 (http://go.microsoft.com/fwlink/p/?LinkId=322049).
- **Administrative Credentials** for any computer on which you’ll be installing
## <a href="" id="step2"></a>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](http://technet.microsoft.com/library/dn458891.aspx#ssl) provides more detailed information.
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](https://technet.microsoft.com/library/dn458891.aspx#ssl) provides more detailed information.
**Create a network share**
@ -116,63 +56,19 @@ You’ll need to deploy a settings storage location, a standard network share wh
1. Set the following share-level Server Message Block (SMB) permissions for the settings storage location folder.
<table>
<colgroup>
<col width="50%" />
<col width="50%" />
</colgroup>
<thead>
<tr class="header">
<th align="left"><strong>User account</strong></th>
<th align="left"><strong>Recommended permissions</strong></th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td align="left"><p>Everyone</p></td>
<td align="left"><p>No permissions</p></td>
</tr>
<tr class="even">
<td align="left"><p>Security group of UE-V users</p></td>
<td align="left"><p>Full control</p></td>
</tr>
</tbody>
</table>
| **User account** | **Recommended permissions** |
|------------------------------|-----------------------------|
| Everyone | No permissions |
| Security group of UE-V users | Full control |
 
1. Set the following NTFS file system permissions for the settings storage location folder.
2. Set the following NTFS file system permissions for the settings storage location folder.
| **User account** | **Recommended permissions** | **Folder** |
|------------------------------|---------------------------------------------------|---------------------------|
| Creator/owner | Full control | Subfolders and files only |
| Security group of UE-V users | List folder/read data, create folders/append data | This folder only |
<table>
<colgroup>
<col width="33%" />
<col width="33%" />
<col width="33%" />
</colgroup>
<thead>
<tr class="header">
<th align="left"><strong>User account</strong></th>
<th align="left"><strong>Recommended permissions</strong></th>
<th align="left"><strong>Folder</strong></th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td align="left"><p>Creator/owner</p></td>
<td align="left"><p>Full control</p></td>
<td align="left"><p>Subfolders and files only</p></td>
</tr>
<tr class="even">
<td align="left"><p>Security group of UE-V users</p></td>
<td align="left"><p>List folder/read data, create folders/append data</p></td>
<td align="left"><p>This folder only</p></td>
</tr>
</tbody>
</table>
 
**Security Note:  **
*\*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:
@ -180,69 +76,73 @@ If you create the settings storage share on a computer running a Windows Server
2. Set the registry key value to *1*.
## <a href="" id="step3"></a>Step 3: Deploy the UE-V 2 Agent
## Step 3: Enable the UE-V service on user devices
For evaluation purposes, enable the service on at least two devices that belong to the same user in your test environment.
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.
The UE-V service is the client-side component that captures user-personalized application and Windows settings and saves them in settings packages. Settings packages are built, locally stored, and copied to the settings storage location.
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.
Before enabling the UE-V service, ensure that you’ve completed the following tasks:
``` syntax
AgentSetup.exe SettingsStoragePath=\\server\settingsshare\%username%
```
- Configure the settings storage location
You must specify the SettingsStoragePath command line parameter as the network share from Step 2. [Deploy a UE-V Agent](http://technet.microsoft.com/library/dn458891.aspx#agent) provides more detailed information.
- Configure the template storage location path
## <a href="" id="step4"></a>Step 4: Test Your UE-V 2 Evaluation Deployment
- Register the UE-V templates for first use. In a PowerShell window, type `register-<TemplateName>` where “TemplateName” is the name of the UE-V template you want to register, and press ENTER.
With Windows 10, version 1607 and later, the UE-V service is installed on user devices. Enable the service to start using UE-V. You can enable the service with the Group Policy editor or with Windows PowerShell.
You can now run a few tests on your UE-V evaluation deployment to see how UE-V works.
To enable the UE-V service with Group Policy:
****
1. Open the device’s **Group Policy Editor**.
1. On the first computer (Computer A), make one or more of these changes:
2. Navigate to **Computer Configuration** &gt; **Administrative Templates** &gt; **Windows Components** &gt; **Microsoft** **User Experience Virtualization**.
1. Open to Windows Desktop and move the taskbar to a different location in the window.
3. Run **Enable UEV**.
4. Restart the device.
To enable the UE-V service with Windows PowerShell:
1. In a PowerShell window, type **Enable-UEV** and press ENTER.
2. Restart the device.
3. In a PowerShell window, type **Get-UEVStatus** and press ENTER to verify that the UE-V service was successfully enabled.
## Step 4: Test your UE-V evaluation deployment
You’re ready to run a few tests on your UE-V evaluation deployment to see how UE-V works.
1. On the first device (Computer A), make one or more of these changes:
1. Open 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**.
3. Open Calculator and set it 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](uev-managing-settings-location-templates-using-windows-powershell-and-wmi.md).
4. Change the behavior of any Windows app, as detailed in [Managing UE-V settings location templates using Windows PowerShell and WMI](uev-managing-settings-location-templates-using-windows-powershell-and-wmi.md).
5. Disable Microsoft Account settings synchronization and Roaming Profiles.
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.
3. Log in to the second device (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.
4. Open 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
- [Microsoft User Experience Virtualization (UE-V) 2.x](index.md)
- [Prepare a UE-V 2.x Deployment](uev-prepare-for-deployment.md)
- [Administering UE-V 2.x](uev-administering-uev.md)
- [Troubleshooting UE-V 2.x](uev-troubleshooting.md)
- [Technical Reference for UE-V 2.x](uev-technical-reference.md)
## Have a suggestion for UE-V?
Add or vote on suggestions [here](http://uev.uservoice.com/forums/280428-microsoft-user-experience-virtualization). For UE-V issues, use the [UE-V TechNet Forum](https://social.technet.microsoft.com/Forums/en-us/home?forum=mdopuev&filter=alltypes&sort=lastpostdesc).
 
 
Other resources for this product
--------------------------------
- [User Experience Virtualization](uev-for-windows.md)
- [Prepare a UE-V Deployment](uev-prepare-for-deployment.md)
- [Administering UE-V ](uev-administering-uev.md)
- [Troubleshooting UE-V ](uev-troubleshooting.md)
- [Technical Reference for UE-V](uev-technical-reference.md)

15
windows/manage/uev-manage-configurations.md
View File

@ -71,23 +71,12 @@ Here are some examples of UE-V configuration settings:
## Have a suggestion for UE-V?
Add or vote on suggestions [here](http://uev.uservoice.com/forums/280428-microsoft-user-experience-virtualization). For UE-V issues, use the [UE-V TechNet Forum](https://social.technet.microsoft.com/Forums/en-us/home?forum=mdopuev&filter=alltypes&sort=lastpostdesc).
## Related topics
[Administering UE-V](uev-administering-uev.md)
[Deploy Required Features for UE-V](uev-deploy-required-features.md)
[Deploy UE-V for Custom Applications](uev-deploy-uev-for-custom-applications.md)
 
 
[Deploy Required UE-V Features](uev-deploy-required-features.md)
[Use UE-V with custom applications](uev-deploy-uev-for-custom-applications.md)

728
windows/manage/uev-prepare-for-deployment.md
View File

@ -1,6 +1,6 @@
---
title: Prepare a UE-V 2.x Deployment
description: Prepare a UE-V 2.x Deployment
title: Prepare a UE-V Deployment
description: Prepare a UE-V Deployment
author: jamiejdt
ms.pagetype: mdop, virtualization
ms.mktglfcycl: deploy
@ -8,371 +8,153 @@ ms.sitesec: library
ms.prod: w10
---
# Prepare a UE-V Deployment
# Prepare a UE-V 2.x Deployment
Applies to: Windows 10, version 1607
Before you deploy User Experience Virtualization (UE-V), review this topic for important information about the type of deployment you’re planning and for preparations you can make beforehand so that your deployment is successful.
There is some planning and preparation to do before you deploy Microsoft User Experience Virtualization (UE-V) 2.0 or 2.1 as a solution for synchronizing settings between devices that users access in your enterprise. This topic helps you determine what type of deployment you'll be doing and what preparation you can make beforehand so that your deployment is successful.
First, review these tasks that you’ll need to do to deploy UE-V:
First, let’s look at the tasks you’ll do to deploy UE-V:
- [Plan your UE-V deployment](#planning)
- [Plan your UE-V Deployment](#planning)
> Before you deploy any UE-V components, review this topic to help you determine which UE-V features to deploy. If you leave this page, be sure to come back and read through the planning information below.
Before you deploy anything, a good first step is to do a little bit of planning so that you can determine which UE-V features you’ll deploy. So if you leave this page, make sure you come back and read through the planning information below.
- [Deploy required UE-V features](uev-deploy-required-features.md)
- [Deploy Required Features for UE-V 2.x](uev-deploy-required-features.md)
> Every UE-V deployment requires these activities:
Every UE-V deployment requires these activities:
- [Define a settings storage location](uev-deploy-required-features.md#ssl)
- [Define a settings storage location](http://technet.microsoft.com/library/dn458891.aspx#ssl)
- [Decide how to manage UE-V configurations](#config)
- [Decide how to deploy the UE-V Agent and manage UE-V configurations](http://technet.microsoft.com/library/dn458891.aspx#config)
- [Enable the UE-V service](uev-deploy-required-features.md#enable-the-ue-v-service) on user computers
- [Install the UE-V Agent](http://technet.microsoft.com/library/dn458891.aspx#agent) on every user computer that needs settings synchronized
- Optionally, you can [Use UE-V with custom applications](uev-deploy-uev-for-custom-applications.md)
- Optionally, you can [Deploy UE-V 2.x for Custom Applications](uev-deploy-uev-for-custom-applications.md)
Review this topic to determine whether you want UE-V to support the synchronization of settings for custom applications (third-party or line-of-business), which requires these UE-V features:
Planning will help you figure out whether you want UE-V to support the synchronization of settings for custom applications (third-party or line-of-business), which requires these UE-V features:
- [Install the UE-V template generator](uev-deploy-uev-for-custom-applications.md#uevgen) so you can create, edit, and validate the custom settings location templates required to synchronize custom application settings
- [Install the UEV Generator](http://technet.microsoft.com/library/dn458942.aspx#uevgen) so you can create, edit, and validate the custom settings location templates required to synchronize custom application settings
- [Create custom settings location templates](uev-deploy-uev-for-custom-applications.md#createcustomtemplates) by using the UE-V generator
- [Create custom settings location templates](http://technet.microsoft.com/library/dn458942.aspx#createcustomtemplates) by using the UE-V Generator
- [Deploy a UE-V settings template catalog](uev-deploy-uev-for-custom-applications.md#deploycatalogue) to store your custom settings location templates
- [Deploy a UE-V settings template catalog](http://technet.microsoft.com/library/dn458942.aspx#deploycatalogue) that you use to store your custom settings location templates
The workflow diagram below illustrates a typical UE-V deployment and the decisions you need to be prepared to make.
This workflow diagram provides a high-level understanding of a UE-V deployment and the decisions that determine how you deploy UE-V in your enterprise.
![UE-V deployment preparation](images/uev-deployment-preparation.png)
![deploymentworkflow](images/deploymentworkflow.png)
<!-- PRESERVING ^ORIGINAL IMAGE CODING JUST IN CASE
<img src="media/image1.png" width="446" height="362" />
-->
**Planning a UE-V deployment:** First, you want to do a little bit of planning so that you can determine which UE-V components you’ll be deploying. Planning a UE-V deployment involves these things:
**Planning a UE-V deployment:** Review the following topics to determine which UE-V components you’ll be deploying.
- [Decide whether to synchronize settings for custom applications](#deciding)
- [Decide whether to synchronize settings for custom applications](#decide-whether-to-synchronize-settings-for-custom-applications)
This determines whether you will install the UE-V Generator during deployment, which lets you create custom settings location templates. It involves the following:
If you want to synchronize settings for custom applications, you’ll need to install the UE-V generator during deployment. Use the generator to create custom settings location templates, which involves the following tasks:
Review the [settings that are synchronized automatically in a UE-V deployment](#autosyncsettings).
- Review the [settings that are synchronized automatically in a UE-V deployment](#settings-automatically-synchronized-in-a-ue-v-deployment).
[Determine whether you need settings synchronized for other applications](#determinesettingssync).
- [Determine whether you need settings synchronized for other applications](#determine-whether-you-need-settings-synchronized-for-other-applications).
- Review [other considerations for deploying UE-V](#considerations), such as high availability and capacity planning.
- Review [other considerations for deploying UE-V](#other-considerations-when-preparing-a-ue-v-deployment), including high availability and capacity planning.
- [Confirm prerequisites and supported configurations for UE-V](#prereqs)
- [Confirm prerequisites and supported configurations for UE-V](#confirm-prerequisites-and-supported-configurations-for-ue-v)
## <a href="" id="deciding"></a>Decide Whether to Synchronize Settings for Custom Applications
## Decide whether to synchronize settings for custom applications
In a UE-V deployment, many settings are automatically synchronized. But you can also customize UE-V to synchronize settings for other applications, such as line-of-business and third-party apps.
In a UE-V deployment, many settings are automatically synchronized. You can also customize UE-V to synchronize settings for other applications, such as line-of-business and third-party apps.
Deciding if you want UE-V to synchronize settings for custom applications is probably the most important part of planning your UE-V deployment. The topics in this section will help you make that decision.
### <a href="" id="autosyncsettings"></a>Settings that are automatically synchronized in a UE-V deployment
### Settings automatically synchronized in a UE-V deployment
This section provides information about the settings that are synchronized by default in UE-V, including the following:
This section explains which settings are synchronized by default in UE-V, including:
Desktop applications whose settings are synchronized by default
- Desktop applications that are synchronized by default
Windows desktop settings that are synchronized by default
- Windows desktop settings that are synchronized by default
A statement of support for Windows app setting synchronization
- A statement of support for Windows applications setting synchronization
See [User Experience Virtualization (UE-V) settings templates for Microsoft Office](http://www.microsoft.com/download/details.aspx?id=46367) to download a complete list of the specific Microsoft Office 2013, Microsoft Office 2010, and Microsoft Office 2007 settings that are synchronized by UE-V.
To download a complete list of the specific Microsoft Office 2013, Microsoft Office 2010, and Microsoft Office 2007 settings that are synchronized by UE-V, use the following links:
### Desktop applications synchronized by default in UE-V 2.1 and UE-V 2.1 SP1
- [User Experience Virtualization (UE-V) settings templates for Microsoft Office](https://www.microsoft.com/download/details.aspx?id=46367)
When you install the UE-V 2.1 or 2.1 SP1 Agent, it registers a default group of settings location templates that capture settings values for these common Microsoft applications.
- [Microsoft Authored Office 2016 UE-V Templates](https://gallery.technet.microsoft.com/Authored-Office-2016-32-0dc05cd8)
**Tip**  
### Desktop applications synchronized by default in UE-V
When you enable the UE-V for Windows service, it registers a default group of settings location templates that capture settings values for these common Microsoft applications.
<!-- TOMMY WILL BE COMMENTING ON THE FOLLOWING. IT IS AT LEAST PARTLY ABOUT OLDER VERSIONS. FOR UPDATED LINKS, LOOK JUST ABOVE THIS SECTION.
**Tip**
**Microsoft Office 2007 Settings Synchronization** – In UE-V 2.1 and 2.1 SP1, a settings location template is no longer included by default for Office 2007 applications. However, you can still use Office 2007 templates from UE-V 2.0 or earlier and can get the templates from the [UE-V template gallery](http://go.microsoft.com/fwlink/p/?LinkID=246589).
-->
 
<table>
<colgroup>
<col width="50%" />
<col width="50%" />
</colgroup>
<thead>
<tr class="header">
<th align="left"><strong>Application category</strong></th>
<th align="left"><strong>Description</strong></th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td align="left"><p>Microsoft Office 2010 applications</p>
<p>([Download a list of all settings synced](http://www.microsoft.com/download/details.aspx?id=46367))</p></td>
<td align="left"><p>Microsoft Word 2010</p>
<p>Microsoft Excel 2010</p>
<p>Microsoft Outlook 2010</p>
<p>Microsoft Access 2010</p>
<p>Microsoft Project 2010</p>
<p>Microsoft PowerPoint 2010</p>
<p>Microsoft Publisher 2010</p>
<p>Microsoft Visio 2010</p>
<p>Microsoft SharePoint Workspace 2010</p>
<p>Microsoft InfoPath 2010</p>
<p>Microsoft Lync 2010</p>
<p>Microsoft OneNote 2010</p>
<p>Microsoft SharePoint Designer 2010</p></td>
</tr>
<tr class="even">
<td align="left"><p>Microsoft Office 2013 applications</p>
<p>([Download a list of all settings synced](http://www.microsoft.com/download/details.aspx?id=46367))</p></td>
<td align="left"><p>Microsoft Word 2013</p>
<p>Microsoft Excel 2013</p>
<p>Microsoft Outlook 2013</p>
<p>Microsoft Access 2013</p>
<p>Microsoft Project 2013</p>
<p>Microsoft PowerPoint 2013</p>
<p>Microsoft Publisher 2013</p>
<p>Microsoft Visio 2013</p>
<p>Microsoft InfoPath 2013</p>
<p>Microsoft Lync 2013</p>
<p>Microsoft OneNote 2013</p>
<p>Microsoft SharePoint Designer 2013</p>
<p>Microsoft Office 2013 Upload Center</p>
<p>Microsoft OneDrive for Business 2013</p>
<p>The UE-V 2.1 and 2.1 SP1 Microsoft Office 2013 settings location templates include improved Outlook signature support. We’ve added synchronization of default signature settings for new, reply, and forwarded emails.</p>
<div class="alert">
<strong>Note</strong>  
<p>An Outlook profile must be created for any device on which a user wants to sync their Outlook signature. If the profile is not already created, the user can create one and then restart Outlook on that device to enable signature synchronization.</p>
</div>
<div>
 
</div></td>
</tr>
<tr class="odd">
<td align="left"><p>Browser options: Internet Explorer 8, Internet Explorer 9, Internet Explorer 10, and Internet Explorer 11</p></td>
<td align="left"><p>Favorites, home page, tabs, and toolbars.</p>
<div class="alert">
<strong>Note</strong>  
<p>UE-V does not roam settings for Internet Explorer cookies.</p>
</div>
<div>
 
</div></td>
</tr>
<tr class="even">
<td align="left"><p>Windows accessories</p></td>
<td align="left"><p>Microsoft Calculator, Notepad, WordPad.</p></td>
</tr>
</tbody>
</table>
| **Application category** | **Description** |
|-----------------------------|-------------------|
| Microsoft Office 2010 applications<br>([Download a list of all settings synced](https://www.microsoft.com/download/details.aspx?id=46367)) | Microsoft Word 2010<br>Microsoft Excel 2010<br>Microsoft Outlook 2010<br>Microsoft Access 2010<br>Microsoft Project 2010<br>Microsoft PowerPoint 2010<br>Microsoft Publisher 2010<br>Microsoft Visio 2010<br>Microsoft SharePoint Workspace 2010<br>Microsoft InfoPath 2010<br>Microsoft Lync 2010<br>Microsoft OneNote 2010<br>Microsoft SharePoint Designer 2010 |
| Microsoft Office 2013 applications<br>([Download a list of all settings synced](https://www.microsoft.com/download/details.aspx?id=46367)) | Microsoft Word 2013<br>Microsoft Excel 2013<br>Microsoft Outlook 2013<br>Microsoft Access 2013<br>Microsoft Project 2013<br>Microsoft PowerPoint 2013<br>Microsoft Publisher 2013<br>Microsoft Visio 2013<br>Microsoft InfoPath 2013<br>Microsoft Lync 2013<br>Microsoft OneNote 2013<br>Microsoft SharePoint Designer 2013<br>Microsoft Office 2013 Upload Center<br>Microsoft OneDrive for Business 2013<br>The UE-V 2.1 and 2.1 SP1 Microsoft Office 2013 settings location templates include improved Outlook signature support. We’ve added synchronization of default signature settings for new, reply, and forwarded emails.<br>**Note**<br>An Outlook profile must be created for any device on which a user wants to sync their Outlook signature. If the profile is not already created, the user can create one and then restart Outlook on that device to enable signature synchronization. |
| Browser options: Internet Explorer 8, Internet Explorer 9, Internet Explorer 10, and Internet Explorer 11 | Favorites, home page, tabs, and toolbars.<br>**Note**<br>UE-V does not roam settings for Internet Explorer cookies. |
| Windows accessories | Microsoft Calculator, Notepad, WordPad. |
 
**Note**  
UE-V 2.1 SP1 does not synchronize settings between the Microsoft Calculator in Windows 10 and the Microsoft Calculator in previous operating systems.
 
**Note**
UE-V does not synchronize settings between the Microsoft Calculator in Windows 10 and the Microsoft Calculator in previous operating systems.
### Desktop applications synchronized by default in UE-V 2.0
When you install the UE-V 2.0 Agent, it registers a default group of settings location templates that capture settings values for these common Microsoft applications.
When you enable the UE-V 2.0 service, it registers a default group of settings location templates that capture settings values for these common Microsoft applications.
**Tip**  
**Microsoft Office 2013 Settings Synchronization** – In UE-V 2.0, a settings location template is not included by default for Office 2013 applications, but is available for download from the [UE-V template gallery](http://go.microsoft.com/fwlink/p/?LinkID=246589). [Synchronizing Office 2013 with UE-V 2.0](uev-synchronizing-office-2013-with-uev.md) provides details about the supported templates that synchronize Office 2013 settings.
**Tip**
**Microsoft Office 2013 Settings Synchronization** – In UE-V 2.0, a settings location template is not included by default for Office 2013 applications, but is available for download from the [UE-V template gallery](http://go.microsoft.com/fwlink/p/?LinkID=246589). [Synchronizing Office 2013 with UE-V 2.0](https://technet.microsoft.com/en-us/itpro/mdop/uev-v2/synchronizing-office-2013-with-ue-v-20-both-uevv2) provides details about the supported templates that synchronize Office 2013 settings.
 
| **Application category** | **Description** |
|-----------------------------|-------------------|
| Microsoft Office 2007 applications<br>([Download a list of all settings synced](https://www.microsoft.com/download/details.aspx?id=46367)) | Microsoft Access 2007<br>Microsoft Communicator 2007<br>Microsoft Excel 2007<br>Microsoft InfoPath 2007<br>Microsoft OneNote 2007<br>Microsoft Outlook 2007<br>Microsoft PowerPoint 2007<br>Microsoft Project 2007<br>Microsoft Publisher 2007<br>Microsoft SharePoint Designer 2007<br>Microsoft Visio 2007<br>Microsoft Word 2007 |
| Microsoft Office 2010 applications<br>([Download a list of all settings synced](https://www.microsoft.com/download/details.aspx?id=46367)) | Microsoft Word 2010<br>Microsoft Excel 2010<br>Microsoft Outlook 2010<br>Microsoft Access 2010<br>Microsoft Project 2010<br>Microsoft PowerPoint 2010<br>Microsoft Publisher 2010<br>Microsoft Visio 2010<br>Microsoft SharePoint Workspace 2010<br>Microsoft InfoPath 2010<br>Microsoft Lync 2010<br>Microsoft OneNote 2010<br>Microsoft SharePoint Designer 2010 |
| Browser options: Internet Explorer 8, Internet Explorer 9, and Internet Explorer 10 | Favorites, home page, tabs, and toolbars.<br>**Note**<br>UE-V does not roam settings for Internet Explorer cookies. |
| Windows accessories | Microsoft Calculator, Notepad, WordPad. |
<table>
<colgroup>
<col width="50%" />
<col width="50%" />
</colgroup>
<thead>
<tr class="header">
<th align="left"><strong>Application category</strong></th>
<th align="left"><strong>Description</strong></th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td align="left"><p>Microsoft Office 2007 applications</p>
<p>([Download a list of all settings synced](http://www.microsoft.com/download/details.aspx?id=46367))</p></td>
<td align="left"><p>Microsoft Access 2007</p>
<p>Microsoft Communicator 2007</p>
<p>Microsoft Excel 2007</p>
<p>Microsoft InfoPath 2007</p>
<p>Microsoft OneNote 2007</p>
<p>Microsoft Outlook 2007</p>
<p>Microsoft PowerPoint 2007</p>
<p>Microsoft Project 2007</p>
<p>Microsoft Publisher 2007</p>
<p>Microsoft SharePoint Designer 2007</p>
<p>Microsoft Visio 2007</p>
<p>Microsoft Word 2007</p></td>
</tr>
<tr class="even">
<td align="left"><p>Microsoft Office 2010 applications</p>
<p>([Download a list of all settings synced](http://www.microsoft.com/download/details.aspx?id=46367))</p></td>
<td align="left"><p>Microsoft Word 2010</p>
<p>Microsoft Excel 2010</p>
<p>Microsoft Outlook 2010</p>
<p>Microsoft Access 2010</p>
<p>Microsoft Project 2010</p>
<p>Microsoft PowerPoint 2010</p>
<p>Microsoft Publisher 2010</p>
<p>Microsoft Visio 2010</p>
<p>Microsoft SharePoint Workspace 2010</p>
<p>Microsoft InfoPath 2010</p>
<p>Microsoft Lync 2010</p>
<p>Microsoft OneNote 2010</p>
<p>Microsoft SharePoint Designer 2010</p></td>
</tr>
<tr class="odd">
<td align="left"><p>Browser options: Internet Explorer 8, Internet Explorer 9, and Internet Explorer 10</p></td>
<td align="left"><p>Favorites, home page, tabs, and toolbars.</p>
<div class="alert">
<strong>Note</strong>  
<p>UE-V does not roam settings for Internet Explorer cookies.</p>
</div>
<div>
 
</div></td>
</tr>
<tr class="even">
<td align="left"><p>Windows accessories</p></td>
<td align="left"><p>Microsoft Calculator, Notepad, WordPad.</p></td>
</tr>
</tbody>
</table>
 
### <a href="" id="autosyncsettings2"></a>Windows settings synchronized by default
### Windows settings synchronized by default
UE-V includes settings location templates that capture settings values for these Windows settings.
<table>
<colgroup>
<col width="20%" />
<col width="20%" />
<col width="20%" />
<col width="20%" />
<col width="20%" />
</colgroup>
<thead>
<tr class="header">
<th align="left">Windows settings</th>
<th align="left">Description</th>
<th align="left">Apply on</th>
<th align="left">Export on</th>
<th align="left">Default state</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td align="left"><p>Desktop background</p></td>
<td align="left"><p>Currently active desktop background or wallpaper.</p></td>
<td align="left"><p>Logon, unlock, remote connect, Scheduled Task events.</p></td>
<td align="left"><p>Logoff, lock, remote disconnect, user clicking <strong>Sync Now</strong> in Company Settings Center, or scheduled task interval</p></td>
<td align="left"><p>Enabled</p></td>
</tr>
<tr class="even">
<td align="left"><p>Ease of Access</p></td>
<td align="left"><p>Accessibility and input settings, Microsoft Magnifier, Narrator, and on-Screen Keyboard.</p></td>
<td align="left"><p>Logon only.</p></td>
<td align="left"><p>Logoff, user clicking <strong>Sync Now</strong> in Company Settings Center, or scheduled task interval</p></td>
<td align="left"><p>Enabled</p></td>
</tr>
<tr class="odd">
<td align="left"><p>Desktop settings</p></td>
<td align="left"><p>Start menu and Taskbar settings, Folder options, Default desktop icons, Additional clocks, and Region and Language settings.</p></td>
<td align="left"><p>Logon only.</p></td>
<td align="left"><p>Logoff, user clicking <strong>Sync Now</strong> in Company Settings Center, or scheduled task</p></td>
<td align="left"><p>Enabled</p></td>
</tr>
</tbody>
</table>
| **Windows settings** | **Description** | **Apply on** | **Export on** | **Default state** |
|----------------------|-----------------|--------------|---------------|-------------------|
| Desktop background | Currently active desktop background or wallpaper. | Logon, unlock, remote connect, Scheduled Task events. | Logoff, lock, remote disconnect, user clicking **Sync Now** in Company Settings Center, or scheduled task interval | Enabled |
| Ease of Access | Accessibility and input settings, Microsoft Magnifier, Narrator, and on-Screen Keyboard. | Logon only. | Logoff, user clicking **Sync Now** in Company Settings Center, or scheduled task interval | Enabled |
| Desktop settings | Start menu and Taskbar settings, Folder options, Default desktop icons, Additional clocks, and Region and Language settings. | Logon only. | Logoff, user clicking **Sync Now** in Company Settings Center, or scheduled task | Enabled |
 
**Note**  
**Note**
Starting in Windows 8, UE-V does not roam settings related to the Start screen, such as items and locations. In addition, UE-V does not support synchronization of pinned taskbar items or Windows file shortcuts.
 
**Important**
UE-V roams taskbar settings between Windows 10 devices. However, UE-V does not synchronize taskbar settings between Windows 10 devices and devices running previous operating systems versions.
**Important**  
UE-V 2.1 SP1 roams taskbar settings between Windows 10 devices. However, UE-V does not synchronize taskbar settings between Windows 10 devices and devices running previous operating systems.
| **Settings group** | **Category** | **Capture** | **Apply** |
|--------------------------|----------------|----------------|--------------|
| **Application Settings** | Windows applications | Close app<br>Windows app settings change event | Start the UE-V App Monitor at startup<br>Open app<br>Windows App Settings change event<br>Arrival of a settings package |
| | Desktop applications | Application closes | Application opens and closes |
| **Desktop settings** | Desktop background | Lock or logoff | Logon, unlock, remote connect, notification of new package arrival, user clicks **Sync Now** in Company Settings Center, or scheduled task runs. |
| | Ease of Access (Common – Accessibility, Narrator, Magnifier, On-Screen-Keyboard) | Lock or Logoff | Logon |
| | Ease of Access (Shell - Audio, Accessibility, Keyboard, Mouse) | Lock or logoff | Logon, unlock, remote connect, notification of new package arrival, user clicks **Sync Now** in Company Settings Center, or scheduled task runs |
| | Desktop settings | Lock or logoff | Logon |
 
### UE-V-support for Windows applications
<table>
<colgroup>
<col width="25%" />
<col width="25%" />
<col width="25%" />
<col width="25%" />
</colgroup>
<thead>
<tr class="header">
<th align="left">Settings group</th>
<th align="left">Category</th>
<th align="left">Capture</th>
<th align="left">Apply</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td align="left"><p><strong>Application Settings</strong></p></td>
<td align="left"><p>Windows apps</p></td>
<td align="left"><p>Close app</p>
<p>Windows app settings change event</p></td>
<td align="left"><p>Start the UE-V App Monitor at startup</p>
<p>Open app</p>
<p>Windows App Settings change event</p>
<p>Arrival of a settings package</p></td>
</tr>
<tr class="even">
<td align="left"><p></p></td>
<td align="left"><p>Desktop applications</p></td>
<td align="left"><p>Application closes</p></td>
<td align="left"><p>Application opens and closes</p></td>
</tr>
<tr class="odd">
<td align="left"><p><strong>Desktop settings</strong></p></td>
<td align="left"><p>Desktop background</p></td>
<td align="left"><p>Lock or logoff</p></td>
<td align="left"><p>Logon, unlock, remote connect, notification of new package arrival, user clicks <strong>Sync Now</strong> in Company Settings Center, or scheduled task runs.</p></td>
</tr>
<tr class="even">
<td align="left"><p></p></td>
<td align="left"><p>Ease of Access (Common – Accessibility, Narrator, Magnifier, On-Screen-Keyboard)</p></td>
<td align="left"><p>Lock or Logoff</p></td>
<td align="left"><p>Logon</p></td>
</tr>
<tr class="odd">
<td align="left"><p></p></td>
<td align="left"><p>Ease of Access (Shell - Audio, Accessibility, Keyboard, Mouse)</p></td>
<td align="left"><p>Lock or logoff</p></td>
<td align="left"><p>Logon, unlock, remote connect, notification of new package arrival, user clicks <strong>Sync Now</strong> in Company Settings Center, or scheduled task runs</p></td>
</tr>
<tr class="even">
<td align="left"><p></p></td>
<td align="left"><p>Desktop settings</p></td>
<td align="left"><p>Lock or logoff</p></td>
<td align="left"><p>Logon</p></td>
</tr>
</tbody>
</table>
For Windows applications, the application developer specifies the settings that are synchronized. You can specify which Windows apps are enabled for settings synchronization.
 
To display a list of Windows applications that can synchronize settings with their package family name, enabled status, and enabled source, at a Windows PowerShell command prompt, enter: Get-UevAppxPackage
### UE-V-support for Windows Apps
For Windows apps, the app developer specifies the settings that are synchronized. You can specify which Windows apps are enabled for settings synchronization.
To display a list of Windows apps that can synchronize settings on a computer with their package family name, enabled status, and enabled source, at a Windows PowerShell command prompt, enter: `Get-UevAppxPackage`
**Note**  
**Note**
As of Windows 8, UE-V does not synchronize Windows app settings if the domain user links their sign-in credentials to their Microsoft Account. This linking synchronizes settings to Microsoft OneDrive so UE-V, which disables synchronization of Windows app settings.
 
### UE-V-support for roaming printers
### UE-V-support for Roaming Printers
UE-V 2.1 SP1 lets network printers roam between devices so that a user has access to their network printers when logged on to any device on the network. This includes roaming the printer that they set as the default.
Users can print to their saved network printers, including their default network printer, from any network device.
Printer roaming in UE-V requires one of these scenarios:
@ -380,16 +162,14 @@ Printer roaming in UE-V requires one of these scenarios:
- The driver for the roaming network printer is pre-installed on any device that needs to access that network printer.
- The printer driver can be obtained from Windows Update.
- The printer driver can be imported from Windows Update.
**Note**  
The UE-V printer roaming feature does **not** roam printer settings or preferences, such as printing double-sided.
**Note**
The UE-V printer roaming feature does not roam printer settings or preferences, such as printing double-sided.
 
### Determine whether you need settings synchronized for other applications
### <a href="" id="determinesettingssync"></a>Determine whether you need settings synchronized for other applications
After you have reviewed the settings that are synchronized automatically in a UE-V deployment, you want to decide whether you will synchronize settings for other applications since this determines how you deploy UE-V throughout your enterprise.
After you have reviewed the settings that are synchronized automatically in a UE-V deployment, you’ll need to decide whether to synchronize settings for other applications as your decision will determine how you deploy UE-V throughout your enterprise.
As an administrator, when you consider which desktop applications to include in your UE-V solution, consider which settings can be customized by users, and how and where the application stores its settings. Not all desktop applications have settings that can be customized or that are routinely customized by users. In addition, not all desktop applications settings can safely be synchronized across multiple computers or environments.
@ -401,122 +181,78 @@ In general, you can synchronize settings that meet the following criteria:
- Settings that can be synchronized between computers without risk of corrupted data. For example, do not use settings that are stored in a database file.
### <a href="" id="checklistsettingssync"></a>Checklist for evaluating custom applications
### Checklist for evaluating custom applications
If you’ve decided that you need settings synchronized for other applications, you can use this checklist to help figure out which applications you’ll include.
If you’ve decided that you need to synchronize settings for other applications, can use this checklist to determine which applications you’ll include.
<table>
<colgroup>
<col width="50%" />
<col width="50%" />
</colgroup>
<thead>
<tr class="header">
<th align="left"></th>
<th align="left">Description</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td align="left"><img src="images/checklistbox.gif" alt="Checklist box" /></td>
<td align="left"><p>Does this application contain settings that the user can customize?</p></td>
</tr>
<tr class="even">
<td align="left"><img src="images/checklistbox.gif" alt="Checklist box" /></td>
<td align="left"><p>Is it important for the user that these settings are synchronized?</p></td>
</tr>
<tr class="odd">
<td align="left"><img src="images/checklistbox.gif" alt="Checklist box" /></td>
<td align="left"><p>Are these user settings already managed by an application management or settings policy solution? UE-V applies application settings at application startup and Windows settings at logon, unlock, or remote connect events. If you use UE-V with other settings sharing solutions, users might experience inconsistency across synchronized settings.</p></td>
</tr>
<tr class="even">
<td align="left"><img src="images/checklistbox.gif" alt="Checklist box" /></td>
<td align="left"><p>Are the application settings specific to the computer? Application preferences and customizations that are associated with hardware or specific computer configurations do not consistently synchronize across sessions and can cause a poor application experience.</p></td>
</tr>
<tr class="odd">
<td align="left"><img src="images/checklistbox.gif" alt="Checklist box" /></td>
<td align="left"><p>Does the application store settings in the Program Files directory or in the file directory that is located in the <strong>Users</strong>\[User name]\<strong>AppData</strong>\<strong>LocalLow</strong> directory? Application data that is stored in either of these locations usually should not synchronize with the user, because this data is specific to the computer or because the data is too large to synchronize.</p></td>
</tr>
<tr class="even">
<td align="left"><img src="images/checklistbox.gif" alt="Checklist box" /></td>
<td align="left"><p>Does the application store any settings in a file that contains other application data that should not synchronize? UE-V synchronizes files as a single unit. If settings are stored in files that include application data other than settings, then synchronizing this additional data can cause a poor application experience.</p></td>
</tr>
<tr class="odd">
<td align="left"><img src="images/checklistbox.gif" alt="Checklist box" /></td>
<td align="left"><p>How large are the files that contain the settings? The performance of the settings synchronization can be affected by large files. Including large files can affect the performance of settings synchronization.</p></td>
</tr>
</tbody>
</table>
 
## <a href="" id="considerations"></a>Other Considerations when Preparing a UE-V Deployment
| | **Description** |
|-------|--------------------------|
| ![Checklist box](images/uev-checklist-box.gif) | Does this application contain settings that the user can customize? |
| ![Checklist box](images/uev-checklist-box.gif) | Is it important for the user that these settings are synchronized? |
| ![Checklist box](images/uev-checklist-box.gif) | Are these user settings already managed by an application management or settings policy solution? UE-V applies application settings at application startup and Windows settings at logon, unlock, or remote connect events. If you use UE-V with other settings sharing solutions, users might experience inconsistency across synchronized settings. |
| ![Checklist box](images/uev-checklist-box.gif) | Are the application settings specific to the computer? Application preferences and customizations that are associated with hardware or specific computer configurations do not consistently synchronize across sessions and can cause a poor application experience. |
| ![Checklist box](images/uev-checklist-box.gif) | Does the application store settings in the Program Files directory or in the file directory that is located in the **Users**\[User name\]&lt;strong&gt;AppData&lt;strong&gt;LocalLow directory? Application data that is stored in either of these locations usually should not synchronize with the user, because this data is specific to the computer or because the data is too large to synchronize. |
| ![Checklist box](images/uev-checklist-box.gif) | Does the application store any settings in a file that contains other application data that should not synchronize? UE-V synchronizes files as a single unit. If settings are stored in files that include application data other than settings, then synchronizing this additional data can cause a poor application experience. |
| ![Checklist box](images/uev-checklist-box.gif) | How large are the files that contain the settings? The performance of the settings synchronization can be affected by large files. Including large files can affect the performance of settings synchronization. |
## Other considerations when preparing a UE-V deployment
You should also consider these things when you are preparing to deploy UE-V:
- [Managing credentials synchronization](#creds)
- [Managing credentials synchronization](#managing-credentials-synchronization-in-ue-v)
- [Windows app settings synchronization](#appxsettings)
- [Windows applications settings synchronization](#windows-applications-settings-synchronization)
- [Custom UE-V settings location templates](#custom)
- [Custom UE-V settings location templates](#custom-ue-v-settings-location-templates)
- [Unintentional user settings configurations](#prevent)
- [Unintentional user settings configurations](#prevent-unintentional-user-settings-configuration)
- [Performance and capacity](#capacity)
- [Performance and capacity](#performance-and-capacity-planning)
- [High availability](#high)
- [High availability](#high-availability-for-ue-v)
- [Computer clock synchronization](#clocksync)
- [Computer clock synchronization](#synchronize-computer-clocks-for-ue-v-settings-synchronization)
### <a href="" id="creds"></a>Managing credentials synchronization in UE-V 2.1 and UE-V 2.1 SP1
### Managing credentials synchronization in UE-V
Many enterprise applications, including Microsoft Outlook and Lync, prompt users for their domain credentials at login. Users have the option of saving their credentials to disk to prevent having to enter them every time they open these applications. Enabling roaming credentials synchronization lets users save their credentials on one computer and avoid re-entering them on every computer they use in their environment. Users can synchronize some domain credentials with UE-V 2.1 and 2.1 SP1.
Many enterprise applications, including Microsoft Outlook and Lync, prompt users for their domain credentials when they log in. Users have the option of saving their credentials to disk to prevent having to enter them every time they open these applications. Enabling roaming credentials synchronization lets users save their credentials on one computer and avoid re-entering them on every computer they use in their environment. Users can synchronize some domain credentials with UE-V.
**Important**  
**Important**
Credentials synchronization is disabled by default. You must explicitly enable credentials synchronization during deployment to implement this feature.
 
UE-V can synchronize enterprise credentials, but does not roam credentials intended only for use on the local computer.
UE-V 2.1 and 2.1 SP1 can synchronize enterprise credentials, but do not roam credentials intended only for use on the local computer.
Credentials are synchronous settings, meaning they are applied to your profile the first time you log in to your computer after UE-V synchronizes.
Credentials are synchronous settings, meaning that they are applied to your profile the first time you log in to your computer after UE-V synchronizes.
Credentials synchronization is managed by its own settings location template, which is disabled by default. You can enable or disable this template through the same methods used for other templates. The template identifier for this feature is RoamingCredentialSettings.
**Important**  
If you are using Active Directory Credential Roaming in your environment, we recommend that you don’t enable the UE-V credential roaming template.
 
**Important**
If you are using Active Directory Credential Roaming in your environment, we recommend that you do not enable the UE-V credential roaming template.
Use one of these methods to enable credentials synchronization:
- Company Settings Center
- PowerShell
- Group Policy
**Note**  
**Note**
Credentials are encrypted during synchronization.
 
[PowerShell](uev-administering-uev-with-windows-powershell-and-wmi.md)**:** Enter this PowerShell cmdlet to enable credential synchronization:
[Company Settings Center](http://technet.microsoft.com/library/dn458903.aspx)**:** Check the Roaming Credential Settings check box under Windows Settings to enable credential synchronization. Uncheck the box to disable it. This check box only appears in Company Settings Center if your account is not configured to synchronize settings using a Microsoft Account.
`Enable-UevTemplate RoamingCredentialSettings`
[PowerShell](http://technet.microsoft.com/library/dn458937.aspx)**:** This PowerShell cmdlet enables credential synchronization:
`Copy`
``` syntax
Enable-UevTemplate RoamingCredentialSettings
```
Use this PowerShell cmdlet to disable credential synchronization:
This PowerShell cmdlet disables credential synchronization:
`Disable-UevTemplate RoamingCredentialSettings`
``` syntax
Disable-UevTemplate RoamingCredentialSettings
```
`Copy`
[Group Policy](http://technet.microsoft.com/library/dn458893.aspx)**:** You must [deploy the latest MDOP ADMX template](http://go.microsoft.com/fwlink/p/?LinkId=393944) to enable credential synchronization through group policy. Credentials synchronization is managed with the Windows settings. To manage this feature with Group Policy, enable the Synchronize Windows settings policy.
<!-- WATCH THE MDOP ADMX templates LINK IN THE NEXT PARAGRAPH. IS IT CURRENT? -->
[Group Policy](uev-configuring-uev-with-group-policy-objects.md)**:** You must [deploy the latest MDOP ADMX template](https://technet.microsoft.com/itpro/mdop/solutions/how-to-download-and-deploy-mdop-group-policy--admx--templates) to enable credential synchronization through group policy. Credentials synchronization is managed with the Windows settings. To manage this feature with Group Policy, enable the Synchronize Windows settings policy.
1. Open Group Policy Editor and navigate to **User Configuration – Administrative Templates – Windows Components – Microsoft User Experience Virtualization**.
@ -540,27 +276,27 @@ Credential files saved by applications into the following locations are synchron
Credentials saved to other locations are not synchronized by UE-V.
### <a href="" id="appxsettings"></a>Windows app settings synchronization
### Windows applications settings synchronization
UE-V manages Windows app settings synchronization in three ways:
UE-V manages Windows application settings synchronization in three ways:
- **Sync Windows Apps:** Allow or deny any Windows app synchronization
- **Sync Windows applications:** Allow or deny any Windows app synchronization
- **Windows App List:** Synchronize a list of Windows apps
- **Windows applications list:** Synchronize a list of Windows apps
- **Unlisted Default Sync Behavior:** Determine the synchronization behavior of Windows apps that are not in the Windows app list.
- **Unlisted default sync behavior:** Determine the synchronization behavior of Windows apps that are not in the Windows app list.
For more information, see the [Windows App List](http://technet.microsoft.com/library/dn458925.aspx#win8applist).
For more information, see the [Windows App List](uev-managing-settings-location-templates-using-windows-powershell-and-wmi.md#win8applist).
### <a href="" id="custom"></a>Custom UE-V settings location templates
### Custom UE-V settings location templates
If you are deploying UE-V to synchronize settings for custom applications, you will use the UE-V Generator to create custom settings location templates for those desktop applications. After you create and test a custom settings location template in a test environment, you can deploy the settings location templates to computers in the enterprise.
If you are deploying UE-V to synchronize settings for custom applications, you’ll use the UE-V template generator to create custom settings location templates for those desktop applications. After you create and test a custom settings location template in a test environment, you can deploy the settings location templates to user computers.
Custom settings location templates must be deployed with an existing deployment infrastructure, like an enterprise software distribution (ESD) method such as System Center Configuration Manager, with preferences, or by configuring an UE-V settings template catalog. Templates that are deployed with Configuration Manager or Group Policy must be registered by using UE-V WMI or Windows PowerShell.
Custom settings location templates must be deployed with an existing deployment infrastructure, like an enterprise software distribution method such as System Center Configuration Manager, with preferences, or by configuring an UE-V settings template catalog. Templates that are deployed with Configuration Manager or Group Policy must be registered by using UE-V WMI or Windows PowerShell.
For more information about custom settings location templates, see [Deploy UE-V 2.x for Custom Applications](uev-deploy-uev-for-custom-applications.md). For more information about using UE-V with Configuration Manager, see [Configuring UE-V 2.x with System Center Configuration Manager 2012](uev-configuring-uev-with-system-center-configuration-manager-2012.md).
For more information about custom settings location templates, see [Use UE-V with custom applications](uev-deploy-uev-for-custom-applications.md). For more information about using UE-V with Configuration Manager, see [Configuring UE-V with System Center Configuration Manager 2012](uev-configuring-uev-with-system-center-configuration-manager-2012.md).
### <a href="" id="prevent"></a>Prevent unintentional user settings configuration
### Prevent unintentional user settings configuration
UE-V downloads new user settings information from a settings storage location and applies the settings to the local computer in these instances:
@ -578,9 +314,9 @@ If UE-V is installed on computer A and computer B, and the settings that you wan
This scenario also applies to Windows settings. If the Windows settings on computer B should be the same as the Windows settings on computer A, then the user should log on and log off computer A first.
If the user settings that the user wants are applied in the wrong order, they can be recovered by performing a restore operation for the specific application or Windows configuration on the computer on which the settings were overwritten. For more information, see [Manage Administrative Backup and Restore in UE-V 2.x](uev-manage-administrative-backup-and-restore.md).
If the user settings that the user wants are applied in the wrong order, they can be recovered by performing a restore operation for the specific application or Windows configuration on the computer on which the settings were overwritten. For more information, see [Manage Administrative Backup and Restore in UE-V](uev-manage-administrative-backup-and-restore.md).
### <a href="" id="capacity"></a>Performance and capacity planning
### Performance and capacity planning
Specify your requirements for UE-V with standard disk capacity and network health monitoring.
@ -588,124 +324,65 @@ UE-V uses a Server Message Block (SMB) share for the storage of settings package
To reduce problems with network latency, create settings storage locations on the same local networks where the users’ computers reside. We recommend 20 MB of disk space per user for the settings storage location.
By default, UE-V synchronization times out after 2 seconds to prevent excessive lag due to a large settings package. You can configure the SyncMethod=SyncProvider setting by using [Group Policy Objects](http://technet.microsoft.com/library/dn458893.aspx).
By default, UE-V synchronization times out after 2 seconds to prevent excessive lag due to a large settings package. You can configure the SyncMethod=SyncProvider setting by using [Group Policy Objects](uev-configuring-uev-with-group-policy-objects.md).
### <a href="" id="high"></a>High Availability for UE-V
### High Availability for UE-V
The UE-V settings storage location and settings template catalog support storing user data on any writable share. To ensure high availability, follow these criteria:
- Format the storage volume with an NTFS file system.
<!-- There's a question out for Tommy on the next item -- the link is very old. -->
- The share can use Distributed File System (DFS) replication, but Distributed File System Replication (DFSR) is specifically not supported. Distributed File System Namespaces (DFSN) are supported. For detailed information, see [Microsoft’s Support Statement Around Replicated User Profile Data](http://go.microsoft.com/fwlink/p/?LinkId=313991).
In addition, because SYSVOL uses DFSR for replication, SYSVOL cannot be used for UE-V data file replication.
- Configure the share permissions and NTFS access control lists (ACLs) as specified in [Deploying the Settings Storage Location for UE-V 2.x](http://technet.microsoft.com/library/dn458891.aspx#ssl).
- Configure the share permissions and NTFS access control lists (ACLs) as specified in [Deploying the Settings Storage Location for UE-V](uev-deploy-required-features.md#ssl).
- Use file server clustering along with the UE-V Agent to provide access to copies of user state data in the event of communications failures.
- Use file server clustering along with the UE-V service to provide access to copies of user state data in the event of communications failures.
- You can store the settings storage path data (user data) and settings template catalog templates on clustered shares, on DFSN shares, or on both.
### <a href="" id="clocksync"></a>Synchronize computer clocks for UE-V settings synchronization
### Synchronize computer clocks for UE-V settings synchronization
Computers that run the UE-V Agent must use a time server to maintain a consistent settings experience. UE-V uses time stamps to determine if settings must be synchronized from the settings storage location. If the computer clock is inaccurate, older settings can overwrite newer settings, or the new settings might not be saved to the settings storage location.
Computers that run the UE-V service must use a time server to maintain a consistent settings experience. UE-V uses time stamps to determine if settings must be synchronized from the settings storage location. If the computer clock is inaccurate, older settings can overwrite newer settings, or the new settings might not be saved to the settings storage location.
## <a href="" id="prereqs"></a>Confirm Prerequisites and Supported Configurations for UE-V
## Confirm prerequisites and supported configurations for UE-V
Before you proceed, ensure that your environment includes these requirements for running UE-V.
Before you proceed, make sure your environment includes these requirements for running UE-V.
<table style="width:100%;">
<colgroup>
<col width="16%" />
<col width="16%" />
<col width="16%" />
<col width="16%" />
<col width="16%" />
<col width="16%" />
</colgroup>
<thead>
<tr class="header">
<th align="left"><strong>Operating system</strong></th>
<th align="left"><strong>Edition</strong></th>
<th align="left"><strong>Service pack</strong></th>
<th align="left"><strong>System architecture</strong></th>
<th align="left"><strong>Windows PowerShell</strong></th>
<th align="left"><strong>Microsoft .NET Framework</strong></th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td align="left"><p>Windows 7</p></td>
<td align="left"><p>Ultimate, Enterprise, or Professional Edition</p></td>
<td align="left"><p>SP1</p></td>
<td align="left"><p>32-bit or 64-bit</p></td>
<td align="left"><p>Windows PowerShell 3.0 or higher</p></td>
<td align="left"><p>.NET Framework 4.5 or higher for UE-V 2.1.</p>
<p>.NET Framework 4 or higher for UE-V 2.0.</p></td>
</tr>
<tr class="even">
<td align="left"><p>Windows Server 2008 R2</p></td>
<td align="left"><p>Standard, Enterprise, Datacenter, or Web Server</p></td>
<td align="left"><p>SP1</p></td>
<td align="left"><p>64-bit</p></td>
<td align="left"><p>Windows PowerShell 3.0 or higher</p></td>
<td align="left"><p>.NET Framework 4.5 or higher for UE-V 2.1.</p>
<p>.NET Framework 4 or higher for UE-V 2.0.</p></td>
</tr>
<tr class="odd">
<td align="left"><p>Windows 8 and Windows 8.1</p></td>
<td align="left"><p>Enterprise or Pro</p></td>
<td align="left"><p>None</p></td>
<td align="left"><p>32-bit or 64-bit</p></td>
<td align="left"><p>Windows PowerShell 3.0 or higher</p></td>
<td align="left"><p>.NET Framework 4.5 or higher</p></td>
</tr>
<tr class="even">
<td align="left"><p>Windows 10</p>
<div class="alert">
<strong>Note</strong>  
<p>Only UE-V 2.1 SP1 supports Windows 10</p>
</div>
<div>
 
</div></td>
<td align="left"><p>Enterprise or Pro</p></td>
<td align="left"><p>None</p></td>
<td align="left"><p>32-bit or 64-bit</p></td>
<td align="left"><p>Windows PowerShell 3.0 or higher</p></td>
<td align="left"><p>.NET Framework 4.6</p></td>
</tr>
<tr class="odd">
<td align="left"><p>Windows Server 2012 and Windows Server 2012 R2</p></td>
<td align="left"><p>Standard or Datacenter</p></td>
<td align="left"><p>None</p></td>
<td align="left"><p>64-bit</p></td>
<td align="left"><p>Windows PowerShell 3.0 or higher</p></td>
<td align="left"><p>.NET Framework 4.5 or higher</p></td>
</tr>
</tbody>
</table>
 
| **Operating system** | **Edition** | **Service pack** | **System architecture** | **Windows PowerShell** | **Microsoft .NET Framework** |
|--------------------------|---------------|------------------|-------------------------|--------------------------|--------------------------------|
| Windows 7 | Ultimate, Enterprise, or Professional Edition | SP1 | 32-bit or 64-bit | Windows PowerShell 3.0 or higher | .NET Framework 4.5 or higher for UE-V 2.1.<br>.NET Framework 4 or higher for UE-V 2.0. |
| Windows Server 2008 R2 | Standard, Enterprise, Datacenter, or Web Server | SP1 | 64-bit | Windows PowerShell 3.0 or higher | .NET Framework 4.5 or higher for UE-V 2.1.<br>.NET Framework 4 or higher for UE-V 2.0. |
| Windows 8 and Windows 8.1 | Enterprise or Pro | None | 32-bit or 64-bit | Windows PowerShell 3.0 or higher | .NET Framework 4.5 or higher |
| Windows 10<br>**Note**<br>Only UE-V 2.1 SP1 supports Windows 10 | Enterprise or Pro | None | 32-bit or 64-bit | Windows PowerShell 3.0 or higher | .NET Framework 4.6 |
| Windows Server 2012 and Windows Server 2012 R2 | Standard or Datacenter | None | 64-bit | Windows PowerShell 3.0 or higher | .NET Framework 4.5 or higher |
Also…
- **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 (http://go.microsoft.com/fwlink/p/?LinkId=322049).
- **MDOP License:** This technology is a part of the Microsoft Desktop Optimization Pack (MDOP). Enterprise customers can get MDOP with Microsoft Software Assurance.
<!-- THE FOLLOWING LINK SHOULD NOT BE USED - IT HAS PROBLEMS
For more information about Microsoft Software Assurance and acquiring MDOP, see How Do I Get MDOP (<http://go.microsoft.com/fwlink/p/?LinkId=322049>).
-->
- **Administrative Credentials** for any computer on which you’ll be installing
**Note**  
- The UE-V Windows PowerShell feature of the UE-V Agent requires .NET Framework 4 or higher and Windows PowerShell 3.0 or higher to be enabled. Download Windows PowerShell 3.0 [here](http://go.microsoft.com/fwlink/?LinkId=309609).
<!-- QUESTIONS ARE OUT TO TOMMY ABOUT THE FOLLOWING - IT APPEARS OUTDATED, SINCE WINDOWS POWERSHELL AND .NET ARE PART OF THE O.S
**Note**
- The UE-V Windows PowerShell feature of the UE-V service requires .NET Framework 4 or higher and Windows PowerShell 3.0 or higher to be enabled. Download Windows PowerShell 3.0 [here](http://go.microsoft.com/fwlink/?LinkId=309609).
- Install .NET Framework 4 or .NET Framework 4.5 on computers that run the Windows 7 or the Windows Server 2008 R2 operating system. The Windows 8, Windows 8.1, and Windows Server 2012 operating systems come with .NET Framework 4.5 installed. The Windows 10 operating system comes with .NET Framework 4.6 installed.
-->
- Install .NET Framework 4 or .NET Framework 4.5 on computers that run the Windows 7 or the Windows Server 2008 R2 operating system. The Windows 8, Windows 8.1, and Windows Server 2012 operating systems come with .NET Framework 4.5 installed. The Windows 10 operating system comes with .NET Framework 4.6 installed.
- The “Delete Roaming Cache” policy for Mandatory profiles is not supported with UE-V and should not be used.
 
There are no special random access memory (RAM) requirements specific to UE-V.
### Synchronization of Settings through the Sync Provider
### Synchronization of settings through the Sync Provider
Sync Provider is the default setting for users, which synchronizes a local cache with the settings storage location in these instances:
@ -717,72 +394,49 @@ Sync Provider is the default setting for users, which synchronizes a local cache
- Application open/close
A scheduled task manages this synchronization of settings every 30 minutes or through certain trigger events for certain applications. For more information, see [Changing the Frequency of UE-V 2.x Scheduled Tasks](uev-changing-the-frequency-of-scheduled-tasks.md).
A scheduled task manages this synchronization of settings every 30 minutes or through certain trigger events for certain applications. For more information, see [Changing the frequency of UE-V scheduled tasks](uev-changing-the-frequency-of-scheduled-tasks.md).
The UE-V Agent synchronizes user settings for computers that are not always connected to the enterprise network (remote computers and laptops) and computers that are always connected to the network (computers that run Windows Server and host virtual desktop interface (VDI) sessions).
The UE-V service synchronizes user settings for computers that are not always connected to the enterprise network (remote computers and laptops) and computers that are always connected to the network (computers that run Windows Server and host virtual desktop interface (VDI) sessions).
**Synchronization for computers with always-available connections:** When you use UE-V on computers that are always connected to the network, you must configure the UE-V Agent to synchronize settings by using the *SyncMethod=None* parameter, which treats the settings storage server as a standard network share. In this configuration, the UE-V Agent can be configured to notify if the import of the application settings is delayed.
**Synchronization for computers with always-available connections:** When you use UE-V on computers that are always connected to the network, you must configure the UE-V service to synchronize settings by using the *SyncMethod=None* parameter, which treats the settings storage server as a standard network share. In this configuration, the UE-V service can be configured to notify if the import of the application settings is delayed.
Enable this configuration through one of these methods:
Enable this configuration using one of these methods:
- During UE-V installation, at the command prompt or in a batch file, set the AgentSetup.exe parameter *SyncMethod = None*. [Deploying the UE-V 2.x Agent](http://technet.microsoft.com/library/dn458891.aspx#agent) provides more information.
- After the UE-V installation, use the Settings Management feature in System Center 2012 Configuration Manager or the MDOP ADMX templates to push the *SyncMethod = None* configuration.
- After you enable the UE-V service on user devices, use the Settings Management feature in System Center 2012 Configuration Manager or the MDOP ADMX templates to push the *SyncMethod = None* configuration.
- Use Windows PowerShell or Windows Management Instrumentation (WMI) to set the *SyncMethod = None* configuration.
**Note**  
These last two methods do not work for pooled virtual desktop infrastructure (VDI) environments.
 
**Note**
These last two methods do not work for pooled virtual desktop infrastructure (VDI) environments.
You must restart the computer before the settings start to synchronize.
**Note**  
**Note**
If you set *SyncMethod = None*, any settings changes are saved directly to the server. If the network connection to the settings storage path is not found, then the settings changes are cached on the device and are synchronized the next time that the sync provider runs. If the settings storage path is not found and the user profile is removed from a pooled VDI environment on logoff, settings changes are lost and the user must reapply the change when the computer is reconnected to the settings storage path.
 
**Synchronization for external sync engines:** The *SyncMethod=External* parameter specifies that if UE-V settings are written to a local folder on the user computer, then any external sync engine (such as OneDrive for Business, Work Folders, Sharepoint, or Dropbox) can be used to apply these settings to the different computers that users access.
**Support for shared VDI sessions:** UE-V 2.1 and 2.1 SP1 provide support for VDI sessions that are shared among end users. You can register and configure a special VDI template, which ensures that UE-V keeps all of its functionality intact for non-persistent VDI sessions.
**Support for shared VDI sessions:** UE-V supports VDI sessions that are shared among end users. You can register and configure a special VDI template, which ensures that UE-V keeps all of its functionality intact for non-persistent VDI sessions.
**Note**  
If you do not enable VDI mode for non-persistent VDI sessions, certain features do not work, such as [back-up/restore and last known good (LKG)](http://technet.microsoft.com/library/dn878331.aspx).
**Note**
If you do not enable VDI mode for non-persistent VDI sessions, certain features do not work, such as [back-up/restore and last known good (LKG)](uev-manage-administrative-backup-and-restore.md).
 
The VDI template is provided with UE-V and is typically available here after installation: C:\\Program Files\\Microsoft User Experience Virtualization\\Templates\\VdiState.xml
The VDI template is provided with UE-V 2.1 and 2.1 SP1 and is typically available here after installation: C:\\Program Files\\Microsoft User Experience Virtualization\\Templates\\VdiState.xml
### Prerequisites for UE-V generator support
### Prerequisites for UE-V Generator support
Install the UE-V generator on the computer that is used to create custom settings location templates. This computer should be able to run the applications whose settings are synchronized. You must be a member of the Administrators group on the computer that runs the UE-V generator software.
Install the UE-V Generator on the computer that is used to create custom settings location templates. This computer should be able to run the applications whose settings are synchronized. You must be a member of the Administrators group on the computer that runs the UE-V Generator software.
The UE-V Generator must be installed on a computer that uses an NTFS file system. The UE-V Generator software requires .NET Framework 4. For more information, see [Deploy UE-V 2.x for Custom Applications](uev-deploy-uev-for-custom-applications.md).
The UE-V generator must be installed on a computer that uses an NTFS file system. The UE-V generator software requires .NET Framework 4. For more information, see [Use UE-V with custom applications](uev-deploy-uev-for-custom-applications.md).
## Other resources for this product
- [User Experience Virtualization](uev-for-windows.md)
- [Microsoft User Experience Virtualization (UE-V) 2.x](index.md)
- [Get Started with UE-V 2.x](uev-getting-started.md)
- [Administering UE-V 2.x](uev-administering-uev.md)
- [Troubleshooting UE-V 2.x](uev-troubleshooting.md)
- [Technical Reference for UE-V 2.x](uev-technical-reference.md)
## Have a suggestion for UE-V?
Add or vote on suggestions [here](http://uev.uservoice.com/forums/280428-microsoft-user-experience-virtualization). For UE-V issues, use the [UE-V TechNet Forum](https://social.technet.microsoft.com/Forums/en-us/home?forum=mdopuev&filter=alltypes&sort=lastpostdesc).
 
 
- [Get started with UE-V](uev-getting-started.md)
- [Administering UE-V ](uev-administering-uev.md)
- [Troubleshooting UE-V ](uev-troubleshooting.md)
- [Technical Reference for UE-V](uev-technical-reference.md)

127
windows/manage/uev-release-notes-1607.md Normal file
View File

@ -0,0 +1,127 @@
---
title: User Experience Virtualization (UE-V) Release Notes
description:User Experience Virtualization (UE-V) Release Notes
author: jamiejdt
ms.pagetype: mdop, virtualization
ms.mktglfcycl: deploy
ms.sitesec: library
ms.prod: w10
---
# User Experience Virtualization (UE-V) Release Notes
Applies to: Windows 10, version 1607
This topic includes information required to successfully install and use UE-V that is not included in the User Experience Virtualization (UE-V) documentation. If there are differences between the information in this topic and other UE-V topics, the latest change should be considered authoritative.
### Upgrading from UE-V 1.0 to the Windows 10, version 1607 in-box version of UE-V is blocked
Version 1.0 of UE-V includes client-side caching technology used to pin the UE-V sync folder, however, this technology was removed in UE-V 2.x. As a result, UE-V 1.0 users are blocked from upgrading to UE-V for Windows 10, version 1607.
WORKAROUND: Unpin the UE-V 1.0 client-side caching sync folder and then upgrade to the in-box version included in UE-V for Windows, version 1607 release.
### UE-V settings location templates for Skype cause Skype to crash
When a user generates a valid settings location template for the Skype desktop application, registers it, and then launches the Skype desktop application, Skype crashes. An ACCESS\_VIOLATION is recorded in the Application Event Log.
WORKAROUND: Remove or unregister the Skype template to allow Skype to work again.
### Existing scripts for silent installations of UE-V may fail
Two changes made to the UE-V installer can cause silent installation scripts that worked for previous versions of UE-V to fail when installing UE-V 2.1 SP1. The first is a new requirement that users must accept the license terms and agree to or decline participation in the Customer Experience Improvement Program (CEIP), even during a silent installation. Using the /q parameter is no longer sufficient to indicate acceptance of the license terms and agreement to participate in CEIP.
Second, the installer now forces a computer restart after installing the UE-V Agent. This can cause an install script to fail if it is not expecting the restart (for example, it installs the UE-V Agent first and then immediately installs the generator).
WORKAROUND: The UE-V installer (.msi) has two new command-line parameters that support silent installations.
| Parameter | Description |
|---------------|--------------|
| /ACCEPTLICENSETERMS=True | Set this parameter to **True** to install UE-V silently. Adding this parameter implies that the user accepts the UE-V license terms, which are found (by default) here: %ProgramFiles%\\Microsoft User Experience Virtualization\\Agent |
| /NORESTART | This parameter prevents the mandatory restart after the UE-V agent is installed. A return code of 3010 indicates that a restart is required prior to using UE-V. |
### Registry settings do not synchronize between App-V and native applications on the same computer
When a computer has an application that is installed through both Application Virtualization (App-V) and locally with a Windows Installer (.msi) file, the registry-based settings do not synchronize between the technologies.
WORKAROUND: To resolve this problem, run the application by selecting one of the two technologies, but not both.
### Unpredictable results with both Office 2010 and Office 2013 installed
When a user has both Office 2010 and Office 2013 installed, any common settings between the two versions of Office are roamed by UE-V. This could cause the Office 2010 package size to be quite large or result in unpredictable conflicts with 2013, particularly if Office 365 is used.
WORKAROUND: Install only one version of Office or limit which settings are synchronized by UE-V.
### Uninstall and re-install of Windows 8 app reverts settings to initial state
While using UE-V settings synchronization for a Windows 8 app, if the user uninstalls the app and then reinstalls the app, the app’s settings revert to their default values. This happens because the uninstall removes the local (cached) copy of the app’s settings but does not remove the local UE-V settings package. When the app is reinstalled and launched, UE-V gather the app settings that were reset to the app defaults and then uploads the default settings to the central storage location. Other computers running the app then download the default settings. This behavior is identical to the behavior of desktop applications.
WORKAROUND: None.
### UE-V does not support roaming settings between 32-bit and 64-bit versions of Microsoft Office
We recommend that you install the 32-bit version of Microsoft Office for both 32-bit and 64-bit operating systems. To choose the Microsoft Office version that you need, click here. (<http://office.microsoft.com/word-help/choose-the-32-bit-or-64-bit-version-of-microsoft-office-HA010369476.aspx>). UE-V supports roaming settings between identical architecture versions of Office. For example, 32-bit Office settings will roam between all 32-bit Office instances. UE-V does not support roaming settings between 32-bit and 64-bit versions of Office.
WORKAROUND: None
### MSI’s are not localized
UE-V includes a localized setup program for both the UE-V Agent and UE-V generator. These MSI files are still available but the user interface is minimized and the MSI’s only display in English. Despite the file being in English, the setup program installs all supported languages during the installation.
WORKAROUND: None
### Favicons that are associated with Internet Explorer 9 favorites do not roam
The favicons that are associated with Internet Explorer 9 favorites are not roamed by User Experience Virtualization and do not appear when the favorites first appear on a new computer.
WORKAROUND: Favicons will appear with their associated favorites once the bookmark is used and cached in the Internet Explorer 9 browser.
### File settings paths are stored in registry
Some application settings store the paths of their configuration and settings files as values in the registry. The files that are referenced as paths in the registry must be synchronized when settings are roamed between computers.
WORKAROUND: Use folder redirection or some other technology to ensure that any files that are referenced as file settings paths are present and placed in the same location on all computers where settings roam.
### Long Settings Storage Paths could cause an error
Keep settings storage paths as short as possible. Long paths could prevent resolution or synchronization. UE-V uses the Settings storage path as part of the calculated path to store settings. That path is calculated in the following way: settings storage path + “settingspackages” + package dir (template ID) + package name (template ID) + .pkgx. If that calculated path exceeds 260 characters, package storage will fail and generate the following error message in the UE-V operational event log:
\[boost::filesystem::copy\_file: The system cannot find the path specified\]
To check the operational log events, open the Event Viewer and navigate to Applications and Services Logs / Microsoft / User Experience Virtualization / Logging / Operational.
WORKAROUND: None.
### Some operating system settings only roam between like operating system versions
Operating system settings for Narrator and currency characters specific to the locale (i.e. language and regional settings) will only roam across like operating system versions of Windows. For example, currency characters will not roam between Windows 7 and Windows 8.
WORKAROUND: None
### UE-V 1 agent generates errors when running UE-V 2 templates
If a UE-V 2 settings location template is distributed to a computer installed with a UE-V 1 agent, some settings fail to synchronize between computers and the agent reports errors in the event log.
WORKAROUND: When migrating from UE-V 1 to UE-V 2 and it is likely you’ll have computers running the previous version of the agent, create a separate UE-V 2.x catalog to support the UE-V 2.x Agent and templates.
## Hotfixes and Knowledge Base articles for UE-V 2.1 SP1
This section contains hotfixes and KB articles for UE-V 2.1 SP1.
| KB Article | Title | Link |
|------------|---------|--------|
| 3018608 | UE-V 2.1 - TemplateConsole.exe crashes when UE-V WMI classes are missing | [support.microsoft.com/kb/3018608/EN-US](http://support.microsoft.com/kb/3018608/EN-US) |
| 2903501 | UE-V: User Experience Virtualization (UE-V) compatibility with user profiles | [support.microsoft.com/kb/2903501/EN-US](http://support.microsoft.com/kb/2903501/EN-US) |
| 2770042 | UE-V Registry Settings | [support.microsoft.com/kb/2770042/EN-US](http://support.microsoft.com/kb/2770042/EN-US) |
| 2847017 | UE-V settings replicated by Internet Explorer | [support.microsoft.com/kb/2847017/EN-US](http://support.microsoft.com/kb/2847017/EN-US) |
| 2769631 | How to repair a corrupted UE-V install | [support.microsoft.com/kb/2769631/EN-US](http://support.microsoft.com/kb/2769631/EN-US) |
| 2850989 | Migrating MAPI profiles with Microsoft UE-V is not supported | [support.microsoft.com/kb/2850989/EN-US](http://support.microsoft.com/kb/2850989/EN-US) |
| 2769586 | UE-V roams empty folders and registry keys | [support.microsoft.com/kb/2769586/EN-US](http://support.microsoft.com/kb/2769586/EN-US) |
| 2782997 | How To Enable Debug Logging in Microsoft User Experience Virtualization (UE-V) | [support.microsoft.com/kb/2782997/EN-US](http://support.microsoft.com/kb/2782997/EN-US) |
| 2769570 | UE-V does not update the theme on RDS or VDI sessions | [support.microsoft.com/kb/2769570/EN-US](http://support.microsoft.com/kb/2769570/EN-US) |
| 2850582 | How To Use Microsoft User Experience Virtualization With App-V Applications | [support.microsoft.com/kb/2850582/EN-US](http://support.microsoft.com/kb/2850582/EN-US) |
| 3041879 | Current file versions for Microsoft User Experience Virtualization | [support.microsoft.com/kb/3041879/EN-US](http://support.microsoft.com/kb/3041879/EN-US) |
| 2843592 | Information on User Experience Virtualization and High Availability | [support.microsoft.com/kb/2843592/EN-US](http://support.microsoft.com/kb/2843592/EN-US) |
## Have a suggestion for UE-V?
Add or vote on suggestions [here](http://uev.uservoice.com/forums/280428-microsoft-user-experience-virtualization). For UE-V issues, use the [UE-V TechNet Forum](https://social.technet.microsoft.com/Forums/en-us/home?forum=mdopuev&filter=alltypes&sort=lastpostdesc).

23
windows/manage/uev-sync-methods.md
View File

@ -73,37 +73,24 @@ This table explains the changes to SyncMethod from UE-V v1.0 to v2.0 to v2.1, as
</tbody>
</table>
 
<!-- TOMMY WILL PROVIDE UPDATES FOR SOME OF THE ITEMS BELOW. THE FIRST ITEM IN PARTICULAR NEEDS ATTENTION. -->
You can configure the sync method in these ways:
- When you [Deploy the UE-V Agent](http://technet.microsoft.com/library/dn458891.aspx#agent) through a command-line parameter or in a batch script
- Through [Group Policy](http://technet.microsoft.com/library/dn458893.aspx) settings
- Through [Group Policy](uev-configuring-uev-with-group-policy-objects.md) settings
- With the [System Center Configuration Pack](http://technet.microsoft.com/library/dn458917.aspx) for UE-V
- With the [System Center Configuration Pack](uev-configuring-uev-with-system-center-configuration-manager-2012.md) for UE-V
- After installation of the UE-V Agent, by using [Windows PowerShell or Windows Management Instrumentation (WMI)](http://technet.microsoft.com/library/dn458937.aspx)
- After installation of the UE-V Agent, by using [Windows PowerShell or Windows Management Instrumentation (WMI)](uev-administering-uev-with-windows-powershell-and-wmi.md)
## Have a suggestion for UE-V?
Add or vote on suggestions [here](http://uev.uservoice.com/forums/280428-microsoft-user-experience-virtualization). For UE-V issues, use the [UE-V TechNet Forum](https://social.technet.microsoft.com/Forums/en-us/home?forum=mdopuev&filter=alltypes&sort=lastpostdesc).
## Related topics
[Deploy Required Features for UE-V](uev-deploy-required-features.md#ssl)
[Deploy Required Features for UE-V](uev-deploy-required-features.md#config)
[Deploy Required UE-V Features](uev-deploy-required-features.md)
[Technical Reference for UE-V](uev-technical-reference.md)
 
 

8
windows/manage/uev-whats-new-in-uev-for-windows.md
View File

@ -10,9 +10,7 @@ ms.prod: w10
# What's New in UE-V for Windows 10, version 1607
User Experience Virtualization (UE-V) for Windows 10, version 1607, includes these new features and capabilities compared to UE-V 2.1. See Microsoft User Experience Virtualization for Windows 10, version 1607, Release Notes for more information about the UE-V for Windows 10, version 1607 release.
<!-- NEED LINK TO RELNOTES WHEN IT'S CLEAR WHERE THEY'LL BE -->
User Experience Virtualization (UE-V) for Windows 10, version 1607, includes these new features and capabilities compared to UE-V 2.1.
## UE-V is now a feature in Windows 10
@ -96,6 +94,4 @@ Add or vote on suggestions [here](http://uev.uservoice.com/forums/280428-microso
- [Prepare a UE-V Deployment](uev-prepare-for-deployment.md)
<!-- ARE THE RELEASE NOTES IN A SEPARATE TOPIC?
- Microsoft User Experience Virtualization for Windows 10, version 1607 Release Notes
-->
- [User Experience Virtualization (UE-V) Release Notes](uev-release-notes-1607.md) for Windows 10, version 1607

2
windows/manage/uev-working-with-custom-templates-and-the-uev-generator.md
View File

@ -155,7 +155,7 @@ Add or vote on suggestions [here](http://uev.uservoice.com/forums/280428-microso
[Administering UE-V](uev-administering-uev.md)
[Deploy UE-V for Custom Applications](uev-deploy-uev-for-custom-applications.md)
[Use UE-V with custom applications](uev-deploy-uev-for-custom-applications.md)