Updating a template in Microsoft User Experience Virtualization fails due to invalid Version value

Symptoms

When attempting to update a UE-V template to a new version, you may receive one or more of the following errors:

WMI:

Invoke-WmiMethod -Path \\COMPUTERNAME\ROOT\microsoft\uev:SettingsLocationTemplate -Name Update -ArgumentList "C:\temp\app.xml"
Invoke-WmiMethod : A non-overrideable qualifier was overridden in a derived class.
At line:1 char:1
+ Invoke-WmiMethod -Path \\COMPUTENAME\ROOT\microsoft\uev:SettingsLocationTempl ...
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ CategoryInfo : InvalidOperation: (:) [Invoke-WmiMethod], ManagementException
+ FullyQualifiedErrorId : InvokeWMIManagementException,Microsoft.PowerShell.Commands.InvokeWmiMethod

PowerShell:

Update-UevTemplate C:\temp\app.xml
Update-UevTemplate : It is not allowed to update template C:\temp\app.xml to a lower version.
At line:1 char:1
+ Update-UevTemplate C:\temp\app.xml
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ CategoryInfo : InvalidOperation: (:) [Update-UevTemplate], TemplateUpdateException
+ FullyQualifiedErrorId : TemplateUpdateToLowerVersion,Microsoft.Uev.Commands.UpdateUevTemplateCommand

This error occurs because the settings location template's VERSION element contains a lower number than the currently applied template. In order to update a template, the version number must be incremented by 1 version higher than the existing version. For example, if the current template contains settings like the following:

PS C:\windows\system32> type C:\temp\app.xml <?xml version="1.0"?> <SettingsLocationTemplate xmlns="http://schemas.microsoft.com/UserExperienceVirtualization/2012/SettingsLocationTemplate"> <Name>app1</Name> <ID>app1-v-1-0</ID> <Version>7</Version>

you will need to increment the Version element to 8 or greater:

<Version>8</Version>

To resolve this error, use the following steps:

Determine the current version by running the PowerShell cmdlet Get-UEVTemplate on a client computer. Pass the name of the executable or part of the name to see the current version. For example, for app.exe, run the commandGet-UevTemplate app:
PS C:\> Get-UevTemplate app
ApplicationName : app
TemplateVersion : 7
PackageVersion : 1
Suite           : False
TemplateId      : app1-v-1-0
Enabled         : True
Open the settings location template in a text editor and increment the Version element by 1. In the example above, the XML should look like this:
<?xml version="1.0"?>
<SettingsLocationTemplate xmlns="http://schemas.microsoft.com/UserExperienceVirtualization/2012/SettingsLocationTemplate">
<Name>app1</Name>
<ID>app1-v-1-0</ID>
<Version>8</Version>
Save the settings location template (typically to the Settings Template Catalog Path) and update by either running the Template Auto Update task (or waiting 24 hours for the daily trigger to automatically execute), or by running theUpdate-UevTemplate cmdlet.

Keywords: kb, vkball, kbtshoot

Article Info