Share via

Deploy UE-V 2.1 SP1 for custom applications

  • Article

Microsoft User Experience Virtualization (UE-V) 2.1 SP1 use 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.

Once you have read through the planning material in Prepare a UE-V 2.1 SP1 deployment and have decided that you want to synchronize settings for line of business or non-Microsoft applications, you can deploy the features of UE-V as described in this article. To start, here are the main steps required to synchronize settings for custom applications:

Prepare to deploy UE-V 2.1 SP1 for custom applications

Before you start deploying the UE-V features that handle custom applications, there are 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 can't create a settings location template from these application types:

  • Virtualized applications

  • Applications that are offered through Terminal Services

  • Java applications

  • Windows apps

Note

UE-V settings location templates can't 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 2.1 SP1 with Application Virtualization applications.

Excluded Locations

The discovery process excludes locations that commonly store application software files that don't synchronize settings well between user computers or computing environments. By default, these are excluded:

  • HKEY_CURRENT_USER registry keys and files to which the logged-on user can't write values

  • HKEY_CURRENT_USER registry keys and files that are associated with the core functionality of the Windows operating system

  • All registry keys that are located in the HKEY_LOCAL_MACHINE hive

  • Files that are located in Program Files directories

  • Files that are located in Users \ [User name] \ AppData \ LocalLow

  • Windows operating system files that are located in %Systemroot%

If registry keys and files that are stored in excluded locations are required to synchronize application settings, you can manually add the locations to the settings location template during the template creation process.

However, only changes to the HKEY_CURRENT_USER hive are synchronizeded.

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 need to include the default templates along with the custom templates in the settings template catalog.

When you Deploy a UE-V agent, 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.

Note

If you disable this policy setting after it has been enabled, the UE-V agent doesn't 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 isn't 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

Old settings packages remain in the settings storage location even if you deploy new settings location templates for an application. These packages aren't read by the agent, but neither are they automatically deleted.

Install the UEV 2.1 SP1 generator

Install the UE-V 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.

To install the UE-V generator

  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.

  2. Double-click the installation file. The User Experience Virtualization Generator Setup wizard opens. Select Next to continue.

  3. Accept the Microsoft Software License Terms, and then select Next.

  4. Select the options for Microsoft Updates and the Customer Experience Improvement Program.

  5. Select the destination folder in which to install the UE-V generator, and then select Next.

  6. Select Install to begin the installation.

    Note

    A prompt for User Account Control appears before the application is installed. Permission is required to install the UE-V generator.

  7. Select 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, select Start, select All Programs, select Microsoft User Experience Virtualization, and then select Microsoft User Experience Virtualization Generator.

    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 upgrade all UE-V agents.

Deploy a settings template catalog

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. 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 2.1 SP1 scheduled tasks.

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 2.1 SP1

  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.

    User account Recommended permissions
    Everyone No Permissions
    Domain Computers Read Permission Levels
    Administrators Read/Write Permission Levels

  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

  4. Select 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.

Create custom settings location templates

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 generator

  1. Select Start, select All Programs, select Microsoft User Experience Virtualization, and then select Microsoft User Experience Virtualization Generator.

  2. Select 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. Select 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.

  5. After the process is completed, select 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:

    • 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.

    • 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.

    Select Next to continue.

  7. Review and edit any Properties, Registry locations, and Files locations for the settings location template.

    • Edit the following properties on the Properties tab:

      • Application Name: The application name that is written in the description of the program files properties.

      • Program name: The name of the program that is taken from the program file properties. This name usually has the .exe file name extension.

      • Product version: The product version number of the .exe file of the application. This property, with the File 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 product.

      • File version: The file version number of the .exe file of the application. This property, 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 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. Select Create, and then select Save to save the settings location template on the computer.

  9. Select Close to close the Settings Template Wizard. Exit the UE-V 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.

Application template schema reference for UE-V details the XML structure of the UE-V settings location template and provides guidance for editing these files.

Deploy the custom settings location templates

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.

Settings location templates can be deployed by using one of these methods:

  • An enterprise 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.

To use the settings template catalog path to deploy UE-V settings location templates

  1. Browse to the network share folder that is 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.

    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 agent, open an elevated command prompt, and browse to %Program Files%\Microsoft User Experience Virtualization \ Agent \ <x86 or x64 >, and then run ApplySettingsTemplateCatalog.exe.

    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.

Prepare a UE-V 2.1 SP1 deployment

Deploy required features for UE-V 2.1 SP1