Product documentation
Profile Management
Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR 7.15
View PDF

Create a definition file

September 25, 2020
Contributed by: 
B C

Definition files define the folders, files, or registries to be synchronized. You can create your own application definition files.

Use the Microsoft UE-V template generator to create a UE-V template file.

  1. Download the Windows Assessment and Deployment Kit (Windows ADK) for Windows 10 from Microsoft website.
  2. Install Windows ADK. Select Microsoft User Experience Virtualization (UE-V) Template Generator. Click Install. Click Finish to close the wizard after the installation completes.
  3. Click Start, click Microsoft User Experience Virtualization, and then click Microsoft User Experience Virtualization Generator.
  4. Click Create a settings location template.
  5. Follow the wizard to specify application related parameters. Click Next to continue.
    Take Notepad as an example. Specify the file path as C:\Windows\System32\notepad.exe.
  6. After the specified application starts, close it.
  7. After the process completes, click Next to continue.
  8. Choose Review Locations in the left pane. Select all the check boxes in the lists for standard and nonstandard registry/files.
  9. Click Create to save the template XML file.
    Take Notepad as the example. Save the template XML file as Notepad.xml.

Note

You might have multiple applications defined in a single UE-V template file.

To convert the UE-V template file to a cross-platform definition file, do the following:

  1. Download the conversion tool here.
  2. From a command prompt, run the command convert show filename to display all application names in the definition file.

  3. Run the following command to convert the UE-V template file to a definition file.
    convert source destination [/Index] [/V]

    [/Index]: Convert only the application specified by index number.

    By default, this tool converts all applications in the UE-V template.

    [/V]: Display verbose information for the conversion.

For cross-platform settings, you must repeat the preceding steps for other operating systems and merge the definition files into one. You can use the Platform element with the OSVersionNumber attribute to merge the files. On Windows 7, a setting folder is at AppData\Application\Win7\folder. On Windows 10, at AppData\Application\Win10\folder.

On Windows 7, the definition file you created looks as follows:

<?xml version="1.0" encoding="utf-8"?>

<GroupDefinitions Version="4.0.0.0" GUID="93E41C6E-2091-1B9B-36BC-7CE94EDC677E">

    <Group Name="Common Settings" GUID="32D83BB6-F3AD-985F-D4BC-655B3D9ACBE2">

        <Object Name="!CTX_ROAMINGAPPDATA!\Application\Win7\folder" GUID="1B43DE3F-EC9C-463c-AC19-CD01D00219B6">

            <Platform>

                <Folder>

                    <Path>!CTX_ROAMINGAPPDATA!\Application\Win7\folder</Path>

                    <Recurse/>

                </Folder>

            </Platform>

        </Object>

    </Group>

</GroupDefinitions>
<!--NeedCopy-->

On Windows 10, the definition file you created looks as follows:

<?xml version="1.0" encoding="utf-8"?>

<GroupDefinitions Version="4.0.0.0" GUID="93E41C6E-2091-1B9B-36BC-7CE94EDC677E">

    <Group Name="Common Settings" GUID="32D83BB6-F3AD-985F-D4BC-655B3D9ACBE2">

        <Object Name="!CTX_ROAMINGAPPDATA!\Application\Win10\folder" GUID="1B43DE3F-EC9C-463c-AC19-CD01D00219B6">

            <Platform>

                <Folder>

                    <Path>!CTX_ROAMINGAPPDATA!\Application\Win10\folder</Path>

                    <Recurse/>

                </Folder>

            </Platform>

        </Object>

    </Group>

</GroupDefinitions>
<!--NeedCopy-->

After merging, the contents of the definition file look as follows:

<?xml version="1.0" encoding="utf-8"?>

<GroupDefinitions Version="4.0.0.0" GUID="93E41C6E-2091-1B9B-36BC-7CE94EDC677E">

    <Group Name="Common Settings" GUID="32D83BB6-F3AD-985F-D4BC-655B3D9ACBE2">

        <Object Name="!CTX_ROAMINGAPPDATA!\Application\%osname%\folder" GUID="1B43DE3F-EC9C-463c-AC19-CD01D00219B6">

            <!-- Assuming that the folder locates differently when in different platforms -->

            <Platform OSVersionNumber="6.1"> <!-- Win7 -->

                <Folder>

                    <Path>!CTX_ROAMINGAPPDATA!\Application\Win7\folder</Path>

                    <Recurse/>

                </Folder>

            </Platform>

            <Platform OSVersionNumber="10.0"> <!-- Win10 -->

                <Folder>

                    <Path>!CTX_ROAMINGAPPDATA!\Application\Win10\folder</Path>

                    <Recurse/>

                </Folder>

            </Platform>

        </Object>

    </Group>

</GroupDefinitions>
<!--NeedCopy-->

For information about configuring cross-platform settings, see Configure cross-platform settings.

For information about the architecture of definition files, see Application definition file structure.

For information about enabling application profiler, see Enable application profiler.

Create a definition file
September 25, 2020
Contributed by: 
B C
September 25, 2020
Contributed by: 
B C

In this article

Site feedback | Your privacy choices footer linkYour Privacy Choices | Privacy and legal terms | Cookie preferences | Consent settings | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.