From f4cffccf062bc81da89421f6bf8732487e25620b Mon Sep 17 00:00:00 2001 From: Maggie Evans Date: Sun, 31 Jul 2016 21:59:26 -0700 Subject: [PATCH] Major updates to these topics --- .../manage/uev-deploy-required-features.md | 59 +++++----- .../uev-deploy-uev-for-custom-applications.md | 72 ++++++------ .../uev-whats-new-in-uev-for-windows.md | 103 ++++++++++++++++++ 3 files changed, 163 insertions(+), 71 deletions(-) create mode 100644 windows/manage/uev-whats-new-in-uev-for-windows.md diff --git a/windows/manage/uev-deploy-required-features.md b/windows/manage/uev-deploy-required-features.md index 8a973e05ad..aa62003baf 100644 --- a/windows/manage/uev-deploy-required-features.md +++ b/windows/manage/uev-deploy-required-features.md @@ -10,7 +10,7 @@ ms.prod: w10 # Deploy required UE-V features -To get up and running with User Experience Virtualization, install and configure the following features. +To get up and running with User Experience Virtualization (UE-V), install and configure the following features. - [Deploy a settings storage location](#deploy-a-ue-v-settings-storage-location) that is accessible to end users. @@ -34,8 +34,7 @@ UE-V requires a location in which to store user settings in settings package fil - Use existing Active Directory for your 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. +> **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 @@ -49,19 +48,19 @@ The settings storage location is defined by setting the SettingsStoragePath conf - With [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 devices in your enterprise - Enterprise computers that are used by multiple end users -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. +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 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 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. @@ -69,17 +68,17 @@ The UE-V service dynamically creates a user-specific settings storage path, with 3. Set the following share-level Server Message Block (SMB) permissions for the settings storage location folder. -| **User account** | **Recommended permissions** | -|------------------------------|-----------------------------| -| Everyone | No permissions | -| Security group of UE-V users | Full control | + | **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 | + | **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 | 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. @@ -98,40 +97,34 @@ The UE-V service uses Active Directory (AD) by default if you don’t define a s 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. +You can configure UE-V before, during, or after you enable the UE-V service on user devices, depending on the configuration method that you use. -- [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. +- [**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 you enable the UE-V service. The UE-V Group Policy ADMX template enables the central management of common UE-V service configuration options and 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. + >**Note** Starting with Windows 10, version 1607, UE-V ADMX templates are installed automatically. -Supported operating systems for the domain controller that deploys the Group Policy Objects include the following: + Group Policy ADMX templates configure the synchronization settings for the UE-V service and enable the central management of common UE-V service configuration settings by using an existing Group Policy infrastructure. -Windows Server 2008 R2 + Supported operating systems for the domain controller that deploys the Group Policy Objects include: -Windows Server 2012 and Windows Server 2012 R2 + Windows Server 2012 and Windows Server 2012 R2 -- [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. +- [**Configuration Manager**](uev-configuring-uev-with-system-center-configuration-manager.md) The UE-V Configuration Pack lets you use the Compliance Settings feature of System Center Configuration Manager to apply consistent configurations across sites where UE-V and Configuration Manager are installed. -- [Windows PowerShell and WMI](uev-administering-uev-with-windows-powershell-and-wmi.md): You can use Windows PowerShell and Windows Management Instrumentation (WMI) to modify the configuration of the UE-V service. +- [**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 the configuration of the UE-V service. -**Note** +>**Note** Registry modification can result in data loss, or the computer becomes unresponsive. We recommend that you use other configuration methods. ## Enable the UE-V service 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: - -- Configure the settings storage location - -- Configure the template storage location path - -- 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. +Before enabling the UE-V service, you need to register the UE-V templates for first time 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. -To enable the UE-V service with Group Policy: +**To enable the UE-V service with Group Policy** 1. Open the device’s **Group Policy Editor**. @@ -141,7 +134,7 @@ To enable the UE-V service with Group Policy: 4. Restart the device. -To enable the UE-V service with Windows PowerShell: +**To enable the UE-V service with Windows PowerShell** 1. In a PowerShell window, type **Enable-UEV** and press ENTER. diff --git a/windows/manage/uev-deploy-uev-for-custom-applications.md b/windows/manage/uev-deploy-uev-for-custom-applications.md index 8946722790..120b0b4602 100644 --- a/windows/manage/uev-deploy-uev-for-custom-applications.md +++ b/windows/manage/uev-deploy-uev-for-custom-applications.md @@ -10,7 +10,7 @@ ms.prod: w10 # Use UE-V with custom applications -User Experience Virtualization (UE-V) uses XML files called **settings location templates** to monitor and synchronize application settings and Windows 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. +User Experience Virtualization (UE-V) uses XML files called ***settings location templates*** to monitor and synchronize application settings and Windows 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. @@ -38,7 +38,7 @@ To start, here are the main steps required to synchronize settings for custom ap - With a UE-V settings template catalog -**Note** +>**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 @@ -57,7 +57,7 @@ Use the UE-V template generator to monitor, discover, and capture the locations - Windows applications -**Note** +>**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: @@ -80,7 +80,7 @@ If registry keys and files that are stored in excluded locations are required to A default group of settings location templates for common Microsoft applications and Windows settings is included with Windows 10, version 1607. 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 with the custom templates in the settings template catalog. -**Important** +>**Important** After you enable the UE-V service, you’ll need to register the settings location templates using the `Register-UevTemplate` cmdlet in Windows PowerShell. 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 with Windows 10, version 1607 are deleted and only the templates that are located in the settings template catalog are used. @@ -90,7 +90,6 @@ If there are customized templates in the settings template catalog that use the You can 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** 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 UE-V service, but neither are they automatically deleted. ### Install the UEV template generator @@ -101,16 +100,14 @@ The UE-V template generator is included in the Windows Assessment and Deployment 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. -**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. +>**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 continue to work. -**To install the UE-V template generator:** - -To install the UE-V template generator: +**To install the UE-V template generator** 1. Go to [Download the Windows ADK](https://developer.microsoft.com/en-us/windows/hardware/windows-assessment-deployment-kit) to access the ADK. -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. +2. Select the **Get Windows ADK for Windows 10** button on this page to start the ADK installer. On the window pictured below, select **Microsoft User Experience Virtualization (UE-V) Template Generator** and then select Install.