Schemareferenz für UE-V 2.x-Anwendungsvorlagen
Letzte Aktualisierung: August 2015
Betrifft: User Experience Virtualization 1.0, User Experience Virtualization 1.0 SP1, User Experience Virtualization 2.0, User Experience Virtualization 2.1
Virtualisierung der Benutzerfreundlichkeit von Microsoft (UE-V) 2.0, 2.1 und 2.1 SP1 verwenden XML-Einstellungsortvorlagen zum Definieren der Einstellungen von Desktopanwendungen und Windows, die von UE-V erfasst und angewendet werden. UE-V umfasst eine Reihe standardmäßiger Einstellungsortvorlagen. Sie können auch mit dem UE-V Generator benutzerdefinierte Einstellungsortvorlagen erstellen.
Ein erfahrener Benutzer kann die XML-Datei für eine Einstellungsortvorlage anpassen. In diesem Thema wird die XML-Struktur der Einstellungsortvorlagen von UE-V 2.1 (SP1) und 2.0 erläutert. Außerdem sind Anleitungen zur Bearbeitung dieser Dateien enthalten.
Schemareferenz für UE-V 2.1- und 2.1 SP1-Anwendungsvorlagen
In diesem Thema wird die XML-Struktur der Einstellungsortvorlage von UE-V 2.1 und 2.1 SP1 erläutert. Außerdem sind Anleitungen zur Bearbeitung dieser Datei enthalten.
Inhalt dieses Abschnitts:
XML-Deklaration und Codierungsattribut
Namespace und Stammelement
Datentypen
Name-Element
ID-Element
Version-Element
Author-Element
Processes- und Process-Element
Application-Element
Common-Element
SettingsLocationTemplate-Element
Anhang: SettingsLocationTemplate.xsd
XML-Deklaration und Codierungsattribut
Obligatorisch: True
Typ: String
Die XML-Deklaration muss das Attribut für die XML-Version 1.0 angeben (<?xml version="1.0">). Vom UE-V Generator erstellte Einstellungsortvorlagen werden in UTF-8-Codierung gespeichert, obwohl die Codierung nicht explizit angegeben wird. Als bewährte Methode wird empfohlen, das Attribut für die UTF-8-Codierung (encoding="UTF-8") einzuschließen. In allen mit dem Produkt gelieferten Vorlagen ist dieses Tag ebenfalls angegeben (siehe Dokumente unter „%ProgramFiles%\Microsoft User Experience Virtualization\Templates“). Beispiel:
<?xml version="1.0" encoding="UTF-8"?>
Namespace und Stammelement
Obligatorisch: True
Typ: String
UE-V verwendet den Namespace "https://schemas.microsoft.com/UserExperienceVirtualization/2012/SettingsLocationTemplate" für alle Anwendungen. "SettingsLocationTemplate" ist das Stammelement und enthält alle anderen Elemente. Verweisen Sie in allen Vorlagen mit dem folgenden Tag auf "SettingsLocationTemplate":
<SettingsLocationTemplate xmlns='https://schemas.microsoft.com/UserExperienceVirtualization/2012/SettingsLocationTemplate'>
Datentypen
Es folgt eine Auflistung der Datentypen für das UE-V-Anwendungsvorlagenschema.
- GUID
"GUID" beschreibt einen standardmäßigen regulären Ausdruck für einen global eindeutigen Bezeichner in der Form "\{[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}\}". Dieser wird im Element "Filesetting\Root\KnownFolder" zum Überprüfen der Formatierung von bekannten Ordnern verwendet.
- FilenameString
"FilenameString" bezieht sich auf den Dateinamen eines zu überwachenden Prozesses. Die Werte sind durch den regulären Ausdruck [^\\\?\*\|<>/:]+ eingeschränkt (d. h., sie können keine umgekehrten Schrägstriche, Sternchen oder Fragezeichen, Platzhalterzeichen, senkrechten Striche, Größer- oder Kleiner-als-Zeichen, Schrägstriche oder Doppelpunkte enthalten).
- IDString
"IDString" bezieht sich auf den ID-Wert von Elementen des Typs "Application", "SettingsLocationTemplate" und Elemente vom Typ "Common" (werden zur Beschreibung von Anwendungssuites verwendet, die gemeinsame Einstellungen verwenden). Er ist durch den gleichen regulären Ausdruck wie "FilenameString" eingeschränkt ([^\\\?\*\|<>/:]+).
- TemplateVersion
"TemplateVersion" ist ein ganzzahliger Wert, der die Revision der Einstellungsortvorlage beschreibt. Der Wert kann zwischen 0 und 2147483647 liegen.
- Empty
"Empty" bezieht sich auf einen NULL-Wert. Dieser wird in "Process\ShellProcess" verwendet, um anzugeben, dass kein zu überwachender Prozess vorhanden ist. Dieser Wert sollte in keinen Anwendungsvorlagen verwendet werden.
- Author
Der Datentyp "Author" ist ein komplexer Typ, der den Autor einer Vorlage angibt. Er enthält zwei untergeordnete Elemente: Name und Email. Innerhalb des Datentyps "Author" ist das Element "Name" obligatorisch, während das Element "Email" optional ist. Dieser Typ ist unter dem Element "SettingsLocationTemplate" ausführlicher beschrieben.
- Range
"Range" definiert eine Ganzzahlklasse, die aus zwei untergeordneten Elementen besteht: Minimum und Maximum. Dieser Datentyp wird im Datentyp "ProcessVersion" implementiert. Wenn er angegeben wird, müssen die Werte "Minimum" und "Maximum" enthalten sein.
- ProcessVersion
"ProcessVersion" definiert einen Typ mit vier untergeordneten Elementen: Major, Minor, Build und Patch. Dieser Datentyp wird vom Element "Process" verwendet, um die Werte "ProductVersion" und "FileVersion" auszufüllen. Für diesen Typ wird ein Wert vom Typ "Range" angegeben. Das untergeordnete Element "Major" ist obligatorisch, die anderen Elemente sind optional.
- Architecture
"Architecture" listet zwei mögliche Werte auf: Win32 und Win64. Diese Werte werden zur Angabe der Prozessarchitektur verwendet.
Process
Der Datentyp "Process" ist ein Container, mit dem von UE-V zu überwachende Prozesse beschrieben werden. Er enthält sechs untergeordnete Elemente: Filename, Architecture, ProductName, FileDescription, ProductVersion und FileVersion. In der folgenden Tabelle ist der entsprechende Datentyp für jedes Element aufgeführt:Element
Datentyp
Obligatorisch
Filename
FilenameString
True
Architecture
Architecture
False
ProductName
String
False
FileDescription
String
False
ProductVersion
ProcessVersion
False
FileVersion
ProcessVersion
False
- Processes
Der Datentyp "Processes" stellt einen Container für eine Sammlung von einem oder mehreren Elementen des Typs "Process" dar. Der Sequenztyp "Processes" unterstützt zwei untergeordnete Elemente: Process und ShellProcess. "Process" ist ein Element des Typs "Process" und "ShellProcess" ist vom Datentyp "Empty". Es muss mindestens ein Element in der Sequenz angegeben werden.
Path
"Path" wird von "RegistrySetting" und "FileSetting" zum Verweisen auf Registrierung und Dateipfade genutzt. Dieses Element unterstützt zwei optionale Attribute: Recursive und DeleteIfNotFound. Beide Werte werden auf den Standardwert "False" festgelegt (default="False")."Recursive" gibt an, dass der Pfad und alle Unterordner für Dateieinstellungen enthalten sind oder dass alle untergeordneten Registrierungsschlüssel für Registrierungseinstellungen enthalten sind. In beiden Fällen sind alle Elemente auf der aktuellen Ebene in den erfassten Daten enthalten. Bei einem Objekt des Typs "FileSettings" sind alle Dateien innerhalb des angegebenen Ordners in den von UE-V erfassten Daten enthalten, Ordner sind jedoch nicht eingeschlossen. Für Registrierungspfade werden alle Werte im aktuellen Pfad erfasst, untergeordnete Registrierungsschlüssel werden jedoch nicht erfasst. In beiden Fällen sollte darauf geachtet werden, eine Erfassung großer Datenmengen oder hoher Anzahlen von Elementen zu vermeiden.
Mit dem Attribut "DeleteIfNotFound" wird die Einstellung aus den Einstellungsspeicherpfaddaten des Benutzers entfernt. Dies kann in Fällen wünschenswert sein, in denen das Entfernen dieser Einstellungen aus dem Paket eine große Menge an Speicherplatz auf dem Einstellungsspeicherpfadserver spart.
- FileMask
"FileMask" gibt nur bestimmte Dateitypen für den Ordner an, der durch "Path" definiert ist. Beispielsweise kann "Path"C:\users\username\files
lauten und "FileMask" könnte mit*.txt
angegeben sein, um nur Textdateien einzuschließen.
- RegistrySetting
"RegistrySetting" stellt einen Container für Registrierungsschlüssel und Werte sowie das zugehörige gewünschte Verhalten von Seiten des UE-V-Agent dar. Innerhalb dieses Typs sind vier untergeordnete Elemente definiert: Path, Name, Exclude und eine Folge der Werte Path und Name.
- FileSetting
"FileSetting" enthält Parameter, die Dateien und Dateipfaden zugeordnet sind. Es sind vier untergeordnete Elemente definiert: Root, Path, FileMask und Exclude. "Root" ist obligatorisch, die anderen Elemente sind optional.
Settings
"Settings" ist ein Container für alle Einstellungen, die für eine bestimmte Vorlage gelten. Er enthält Instanzen der zuvor beschriebenen Einstellungen "Registry", "File", "SystemParameter" und "CustomAction". Darüber hinaus können auch die folgenden untergeordneten Elemente mit dem beschriebenen Verhalten enthalten sein:Element
Beschreibung
Asynchronous
Einstellungspakete vom Typ "Asynchronous" werden angewendet, ohne das Starten der Anwendung zu blockieren, sodass der Startvorgang der Anwendung fortgesetzt wird, während die Einstellungen noch angewendet werden. Dies ist im Fall von Einstellungen nützlich, die asynchron angewendet werden können, z. B. bei
get/set
über eine API, wie "SystemParameterSetting".PreventOverlappingSynchronization
In der Standardeinstellung speichert UE-V nur Einstellungen für eine Anwendung, wenn die letzte Instanz einer Anwendung, die die Vorlage verwendet, geschlossen wird. Wenn dieses Element auf "False" festgelegt ist, exportiert UE-V die Einstellungen auch dann, wenn andere Instanzen einer Anwendung ausgeführt werden. Geeignete Vorlagen (enthalten einen Elementabschnitt "Common"), die zum Lieferumfang von UE-V gehören, nutzen dieses Flag zum Aktivieren gemeinsam genutzter Einstellungen, sodass immer beim Schließen der Anwendung exportiert wird, während der Export anwendungsspezifischer Einstellungen bis zum Schließen der letzten Instanz verhindert wird.
AlwaysApplySettings
(mit 2.1 eingeführt)
Dieser Parameter erzwingt das Anwenden eines importierten Einstellungspakets, auch wenn keine Unterschiede zwischen dem Paket und dem aktuellen Zustand der Anwendung bestehen. Dieser Parameter sollte nur in besonderen Fällen verwendet werden, da er den Einstellungsimport verlangsamen kann.
Name-Element
Obligatorisch: True
Typ: String
"Name" gibt einen eindeutigen Namen für die Einstellungsortvorlage an. Dieser wird für Anzeigezwecken verwendet, wenn auf die Vorlage in WMI, PowerShell, der Ereignisanzeige und Debugprotokollen verwiesen wird. Vermeiden Sie allgemein Verweise auf Versionsinformationen, da diese aus dem Element "ProductVersion" entnommen werden können. Geben Sie z. B. <Name>My Application</Name>
statt <Name>My Application 1.1</Name>
an.
Hinweis
UE-V verweist nicht auf externe DTDs, und daher ist es nicht möglich, benannte Entitäten in einer Einstellungsortvorlage zu verwenden. Verwenden Sie beispielsweise nicht "&Reg;", um auf das Zeichen für eine eingetragene Marke ® zu verweisen. Verwenden Sie stattdessen kanonisch nummerierte Verweise, um diese Arten von Sonderzeichen aufzunehmen, z. B. "®" für das ®-Zeichen. Diese Regel gilt für alle Zeichenfolgenwerte in diesem Dokument.
Eine vollständige Liste der Zeichenentitäten finden Sie unter http://www.w3.org/TR/xhtml1/dtds.html. UTF-8-codierte Dokumente können direkt die Unicode-Zeichen enthalten. Beim Speichern von Vorlagen über den UE-V Generator werden Zeichenentitäten automatisch in die jeweiligen Unicode-Darstellungen konvertiert.ID-Element
Obligatorisch: True
Typ: String
"ID" gibt einen eindeutigen Bezeichner für eine bestimmte Vorlage an. Dieses Tag wird zum primären Bezeichner, den der UE-V-Agent verwendet, um zur Laufzeit auf die Vorlage zu verweisen (z. B. Anzeigen der Ausgabe der PowerShell-Cmdlets "Get-UevTemplate" und "Get-UevTemplateProgram"). Gemäß der Konvention sollte dieses Tag keine Leerzeichen enthalten, wodurch das Erstellen von Skripts vereinfacht wird. Versionsnummern von Anwendungen sollten in diesem Element zur leichteren Identifizierung der Vorlage angegeben werden, z. B. <ID>MicrosoftCalculator6</ID>
oder <ID>MicrosoftOffice2010Win64</ID>
.
Version-Element
Obligatorisch: True
Typ: Integer
Mindestwert: 0
Höchstwert: 2147483647
"Version" gibt die Version der Einstellungsortvorlage für das administrative Verfolgen von Änderungen an. Der UE-V Generator erhöht diese Zahl bei jedem Speichern der Vorlage automatisch um eins. Beachten Sie, dass dieses Feld eine Ganzzahl enthalten muss. Zahlen mit Dezimaltrennzeichen, wie z. B. <Version>2.5</Version>
, sind nicht zulässig.
Hinweis: Sie können Hinweise zu Versionsänderungen mithilfe von XML-Kommentartags <!-- -->
speichern. Beispiel:
<!--
Version History
Version 1 Jul 05, 2012 Initial template created by Generator - Denise@Contoso.com
Version 2 Jul 31, 2012 Added support for app.exe v2.1.3 - Mark@Contoso.com
Version 3 Jan 01, 2013 Added font settings support - Mark@Contoso.com
Version 4 Jan 31, 2013 Added support for plugin settings - Tony@Contoso.com
-->
<Version>4</Version>
Wichtig
Dieser Wert wird abgefragt, um festzustellen, ob eine neue Version einer Vorlage in folgenden Fällen auf eine vorhandene Vorlage angewendet werden soll:
- Wenn der geplante Task "Vorlage automatisch aktualisieren" ausgeführt wird.
- Wenn das PowerShell-Cmdlet "Update-UevTemplate" ausgeführt wird.
- Wenn die Aktualisierungsmethode "microsoft\uev:SettingsLocationTemplate" über WMI aufgerufen wird.
Author-Element
Obligatorisch: False
Typ: String
"Author" gibt den Ersteller der Einstellungsortvorlage an. Es werden zwei optionale untergeordnete Elemente unterstützt: Name und Email. Beide Attribute sind optional, doch wenn das untergeordnete Element "Email" angegeben wird, muss auch das Element "Name" angegeben werden. "Author" bezieht sich auf den vollständigen Namen des Kontakts für die Einstellungsortvorlage, und "Email" sollte auf eine E-Mail-Adresse für den Autor verweisen. Es wird empfohlen, diese Informationen in veröffentlichte Vorlagen einzuschließen, z. B. im UE-V-Vorlagenkatalog.
Processes- und Process-Element
Obligatorisch: True
Typ: Element
"Processes" enthält mindestens ein <Process>
-Element, das wiederum die folgenden untergeordneten Elemente enthält: Filename, Architecture, ProductName, FileDescription, ProductVersion und FileVersion. Das untergeordnete Element "Filename" ist obligatorisch, die anderen Elemente sind optional. Ein vollständig ausgefülltes Element enthält Tags, die dem folgenden Beispiel ähneln:
<Process>
<Filename>MyApplication.exe</Filename>
<Architecture>Win64</Architecture>
<ProductName> MyApplication </ProductName>
<FileDescription>MyApplication.exe</FileDescription>
<ProductVersion>
<Major Minimum="2" Maximum="2" />
<Minor Minimum="0" Maximum="0" />
<Build Minimum="0" Maximum="0" />
<Patch Minimum="5" Maximum="5" />
</ProductVersion>
<FileVersion>
<Major Minimum="2" Maximum="2" />
<Minor Minimum="0" Maximum="0" />
<Build Minimum="0" Maximum="0" />
<Patch Minimum="5" Maximum="5" />
</FileVersion>
</Process>
Filename
Obligatorisch: True
Typ: String
"Filename" bezieht sich auf den tatsächlichen Dateinamen der ausführbaren Datei, wie er im Dateisystem angezeigt wird. Dieses Element gibt das primäre Kriterium an, das von UE-V zur Auswertung verwendet wird, ob eine Vorlage auf einen Prozess angewendet wird oder nicht. Dieses Element muss in der XML-Datei der Einstellungsortvorlage angegeben sein.
Gültige Dateinamen dürfen dem regulären Ausdruck [^\\\?\*\|<>/:]+ nicht entsprechen. Das heißt, sie können keine umgekehrten Schrägstriche, Sternchen oder Fragezeichen, Platzhalterzeichen, senkrechten Striche, Größer- oder Kleiner-als-Zeichen, Schrägstriche oder Doppelpunkte (die Zeichen \ ? * | < > / oder :) enthalten.
Hinweis: Zum Testen einer Zeichenfolge anhand dieses regulären Ausdrucks verwenden Sie ein PowerShell-Befehlsfenster und ersetzen YourFileName durch den Namen der ausführbaren Datei:
"YourFileName.exe" -match "[\\\?\*\|<>/:]+"
Der Wert True gibt an, dass die Zeichenfolge unzulässige Zeichen enthält. Hier einige Beispiele für ungültige Werte:
\\server\share\program.exe
Program*.exe
Pro?ram.exe
Program<1>.exe
Hinweis
Der UE-V Generator codiert das Größer- und Kleiner-als-Zeichen als > bzw. <.
In seltenen Fällen enthält der Wert für "FileName" nicht zwangsläufig die Erweiterung ".exe", doch sollte sie als Teil des Werts angegeben werden. So sollte beispielsweise <Filename>MyApplictication.exe</Filename>
statt <Filename>MyApplictication</Filename>
angegeben werden. Im zweiten Beispiel wird die Vorlage nicht für den Prozess angewendet, wenn der tatsächliche Name der ausführbaren Datei "MyApplication.exe" lautet.
Architecture
Obligatorisch: False
Typ: Architecture (String)
"Architecture" bezieht sich auf die Prozessorarchitektur, für die die ausführbare Zieldatei kompiliert wurde. Gültige Werte sind "Win32" für 32-Bit-Anwendungen oder "Win64" für 64-Bit-Anwendung. Falls vorhanden, beschränkt dieses Tag die Anwendbarkeit der Einstellungsortvorlage auf eine bestimmte Anwendungsarchitektur. Als ein Beispiel dafür vergleichen Sie die Dateien "%ProgramFiles%\Microsoft User Experience Virtualization\templates\MicrosoftOffice2010Win32.xml" und "MicrosoftOffice2010Win64.xml", die in UE-V enthalten sind. Dies ist nützlich, wenn sich relative Pfade zwischen verschiedenen Versionen einer ausführbaren Datei ändern oder Einstellungen beim Wechsel von einer Prozessorarchitektur zu einer anderen hinzugefügt oder entfernt wurden.
Wenn dieses Element nicht vorhanden ist, wird die Architektur des Prozesses von der Einstellungsortvorlage ignoriert, und die Vorlage wird sowohl für 32- als auch 64-Bit-Prozesse angewendet, falls der Dateiname und andere Attribute zutreffen.
Hinweis
UE-V unterstützt in dieser Version keine ARM-Prozessoren.
ProductName
Obligatorisch: False
Typ: String
"ProductName" ist ein optionales Element, das zum Angeben eines Produkt zu administrativen oder Berichtszwecken verwendet wird. "ProductName" unterscheidet sich von "Filename" in der Hinsicht, dass keine Einschränkungen für reguläre Ausdrücke beim Wert bestehen. Dies ermöglicht besser verständliche Beschreibungen eines Prozesses, bei dem der Name der ausführbaren Datei möglicherweise nicht eindeutig ist. Beispiel:
<Process>
<Filename>MyApplication.exe</Filename>
<ProductName>My Application 6.x by Contoso.com</ProductName>
<ProductVersion>
<Major Minimum="6" Maximum="6" />
</ProductVersion>
</Process>
FileDescription
Obligatorisch: False
Typ: String
"FileDescription" ist ein optionales Tag, das eine administrative Beschreibung der ausführbaren Datei ermöglicht. Dies ist ein Freitextfeld und kann bei der Unterscheidung zwischen mehreren ausführbaren Dateien innerhalb eines Softwarepakets hilfreich sein, bei denen die Funktion der ausführbaren Datei zu erkennen sein muss.
Bei einer geeigneten Anwendung kann es z. B. nützlich sein, Erinnerungen zur Funktion von zwei ausführbaren Dateien ("MyApplication.exe" und "MyApplicationHelper.exe") bereitzustellen, wie es nachfolgend gezeigt ist:
<Processes>
<Process>
<Filename>MyApplication.exe</Filename>
<FileDescription>My Application Main Engine</ FileDescription>
<ProductVersion>
<Major Minimum="6" Maximum="6" />
</ProductVersion>
</Process>
<Process>
<Filename>MyApplicationHelper.exe</Filename>
<FileDescription>My Application Background Process Executable</FileDescription>
<ProductVersion>
<Major Minimum="6" Maximum="6" />
</ProductVersion>
</Process>
</Processes>
ProductVersion
Obligatorisch: False
Typ: String
"ProductVersion" bezieht sich auf die Haupt- und Nebenproduktversionen einer Datei sowie auf eine Build- und Patchebene. "ProductVersion" ist ein optionales Element, und wenn es angegeben wird, muss es mindestens das untergeordnete Element "Major" enthalten. Der Wert muss einen Bereich in der Form 'Minimum="X" Maximum="Y"' angeben, wobei X und Y ganze Zahlen sind. Die Werte "Minimum" und "Maximum" können identisch sein.
Die Elemente für die Produkt- und Dateiversion müssen nicht angegeben werden. Dadurch wird die Vorlage "versionsunabhängig", was bedeutet, dass die Vorlage für alle Versionen der angegebenen ausführbaren Datei angewendet wird.
Beispiel 1:
Bei Angabe der Produktversion 1.0 im UE-V Generator wird folgende XML erzeugt:
<ProductVersion>
<Major Minimum="1" Maximum="1" />
<Minor Minimum="0" Maximum="0" />
</ProductVersion>
Beispiel 2:
Bei Angabe der Dateiversion 5.0.2.1000 im UE-V Generator wird folgende XML erzeugt:
<FileVersion>
<Major Minimum="5" Maximum="5" />
<Minor Minimum="0" Maximum="0" />
<Build Minimum="2" Maximum="2" />
<Patch Minimum="1000" Maximum="1000" />
</FileVersion>
Beispiel 1 für eine falsche Angabe – unvollständiger Bereich:
Nur das Attribut "Minimum" ist vorhanden. Auch "Maximum" muss im Bereich angegeben werden.
<ProductVersion>
<Major Minimum="2" />
</ProductVersion>
Beispiel 2 für eine falsche Angabe – "Minor" ohne "Major" angegeben:
Nur das Element "Minor" ist vorhanden. Auch "Major" muss angegeben werden.
<ProductVersion>
<Minor Minimum="0" Maximum="0" />
</ProductVersion>
FileVersion
Obligatorisch: False
Typ: String
"FileVersion" unterscheidet zwischen der Releaseversion einer veröffentlichten Anwendung und den internen Builddetails der ausführbaren Datei einer Komponente. Bei den meisten kommerziellen Anwendungen sind diese Nummern identisch. In den Fällen, in denen sie sich unterscheiden, gibt die Produktversion einer Datei eine generische Versionskennung einer Datei an, während die Dateiversion einen bestimmten Build einer Datei angibt (z. B. im Fall eines Hotfixes oder Updates). Dadurch werden Dateien ohne Bruch der Erkennungslogik eindeutig identifiziert.
Um die Produktversion und Dateiversion einer bestimmten ausführbaren Datei zu ermitteln, klicken Sie in Windows-Explorer mit der rechten Maustaste auf die Datei, wählen Sie "Eigenschaften" aus, und klicken Sie dann auf die Registerkarte "Details".
Das Einschließen eines Elements vom Typ "FileVersion" für eine Anwendung ermöglicht eine präzisere Feinabstimmung der Erkennungslogik, ist aber bei den meisten Anwendungen nicht erforderlich. Die Einstellungen des Elements "ProductVersion" werden zuerst überprüft, und anschließend wird "FileVersion" geprüft. Die stärker einschränkende Einstellung wird angewendet.
Die untergeordneten Elemente und Syntaxregeln für "FileVersion" sind mit denen von "ProductVersion" identisch.
<Process>
<Filename>MSACCESS.EXE</Filename>
<Architecture>Win32</Architecture>
<ProductVersion>
<Major Minimum="14" Maximum="14" />
<Minor Minimum="0" Maximum="0" />
</ProductVersion>
<FileVersion>
<Major Minimum="14" Maximum="14" />
<Minor Minimum="0" Maximum="0" />
</FileVersion>
</Process>
Application-Element
"Application" ist ein Container für Einstellungen, die für eine bestimmte Anwendung gelten. Dabei handelt es sich um eine Sammlung der folgenden Felder/Typen.
Feld/Typ |
Beschreibung |
Name |
Gibt einen eindeutigen Namen für die Einstellungsortvorlage an. Dieser wird für Anzeigezwecken verwendet, wenn auf die Vorlage in WMI, PowerShell, der Ereignisanzeige und Debugprotokollen verwiesen wird. Weitere Informationen finden Sie unter Name-Element. |
ID |
Gibt einen eindeutigen Bezeichner für eine bestimmte Vorlage an. Dieses Tag wird zum primären Bezeichner, den der UE-V-Agent verwendet, um zur Laufzeit auf die Vorlage zu verweisen. Weitere Informationen finden Sie unter ID-Element. |
Beschreibung |
Eine optionale Beschreibung der Vorlage. |
LocalizedNames |
Ein optionaler Name, der auf der Benutzeroberfläche angezeigt wird und entsprechend einem Gebietsschema lokalisiert ist. |
LocalizedDescriptions |
Eine optionale Vorlagenbeschreibung, die entsprechend einem Gebietsschema lokalisiert ist. |
Version |
Gibt die Version der Einstellungsortvorlage für das administrative Verfolgen von Änderungen an. Weitere Informationen finden Sie unter Version-Element. |
DeferToMSAccount |
Steuert, ob diese Vorlage in Verbindung mit einem Microsoft-Konto aktiviert wird oder nicht. Wenn die MSA-Synchronisierung für einen Benutzer auf einem Computer aktiviert ist, wird diese Vorlage automatisch deaktiviert. |
DeferToOffice365 |
Ähnlich wie MSA steuert dies, ob diese Vorlage in Verbindung mit Office 365 aktiviert wird. Wenn Office 365 für das Synchronisieren von Einstellungen verwendet wird, wird diese Vorlage automatisch deaktiviert. |
FixedProfile (mit 2.1 eingeführt) |
Gibt an, dass diese Vorlage nur dem Profil zugeordnet werden kann, das innerhalb dieses Elements angegeben ist, und nicht über WMI oder PowerShell geändert werden kann. |
Processes |
Ein Container für eine Sammlung von einem oder mehreren Elementen der Typs "Process". Weitere Informationen finden Sie unter Processes- und Process-Element. |
Settings |
Ein Container für alle Einstellungen, die für eine bestimmte Vorlage gelten. Er enthält Instanzen der Einstellungen "Registry", "File", "SystemParameter" und "CustomAction". Weitere Informationen finden Sie unter Settings im Abschnitt Datentypen. |
Common-Element
"Common" ähnelt einem Element vom Typ "Application", ist aber immer mindestens zwei Elementen vom Typ "Application" zugeordnet. Der Abschnitt "Common" stellt die Gruppe von Einstellungen dar, die von diesen Anwendungsinstanzen gemeinsam genutzt werden. Dabei handelt es sich um eine Sammlung der folgenden Felder/Typen.
Feld/Typ |
Beschreibung |
Name |
Gibt einen eindeutigen Namen für die Einstellungsortvorlage an. Dieser wird für Anzeigezwecken verwendet, wenn auf die Vorlage in WMI, PowerShell, der Ereignisanzeige und Debugprotokollen verwiesen wird. Weitere Informationen finden Sie unter Name-Element. |
ID |
Gibt einen eindeutigen Bezeichner für eine bestimmte Vorlage an. Dieses Tag wird zum primären Bezeichner, den der UE-V-Agent verwendet, um zur Laufzeit auf die Vorlage zu verweisen. Weitere Informationen finden Sie unter ID-Element. |
Beschreibung |
Eine optionale Beschreibung der Vorlage. |
LocalizedNames |
Ein optionaler Name, der auf der Benutzeroberfläche angezeigt wird und entsprechend einem Gebietsschema lokalisiert ist. |
LocalizedDescriptions |
Eine optionale Vorlagenbeschreibung, die entsprechend einem Gebietsschema lokalisiert ist. |
Version |
Gibt die Version der Einstellungsortvorlage für das administrative Verfolgen von Änderungen an. Weitere Informationen finden Sie unter Version-Element. |
DeferToMSAccount |
Steuert, ob diese Vorlage in Verbindung mit einem Microsoft-Konto aktiviert wird oder nicht. Wenn die MSA-Synchronisierung für einen Benutzer auf einem Computer aktiviert ist, wird diese Vorlage automatisch deaktiviert. |
DeferToOffice365 |
Ähnlich wie MSA steuert dies, ob diese Vorlage in Verbindung mit Office 365 aktiviert wird. Wenn Office 365 für das Synchronisieren von Einstellungen verwendet wird, wird diese Vorlage automatisch deaktiviert. |
FixedProfile (mit 2.1 eingeführt) |
Gibt an, dass diese Vorlage nur dem Profil zugeordnet werden kann, das innerhalb dieses Elements angegeben ist, und nicht über WMI oder PowerShell geändert werden kann. |
Settings |
Ein Container für alle Einstellungen, die für eine bestimmte Vorlage gelten. Er enthält Instanzen der Einstellungen "Registry", "File", "SystemParameter" und "CustomAction". Weitere Informationen finden Sie unter Settings im Abschnitt Datentypen. |
SettingsLocationTemplate-Element
Dieses Element definiert die Einstellungen für eine einzelne Anwendung oder eine Suite von Anwendungen.
Feld/Typ |
Beschreibung |
Name |
Gibt einen eindeutigen Namen für die Einstellungsortvorlage an. Dieser wird für Anzeigezwecken verwendet, wenn auf die Vorlage in WMI, PowerShell, der Ereignisanzeige und Debugprotokollen verwiesen wird. Weitere Informationen finden Sie unter Name-Element. |
ID |
Gibt einen eindeutigen Bezeichner für eine bestimmte Vorlage an. Dieses Tag wird zum primären Bezeichner, den der UE-V-Agent verwendet, um zur Laufzeit auf die Vorlage zu verweisen. Weitere Informationen finden Sie unter ID-Element. |
Beschreibung |
Eine optionale Beschreibung der Vorlage. |
LocalizedNames |
Ein optionaler Name, der auf der Benutzeroberfläche angezeigt wird und entsprechend einem Gebietsschema lokalisiert ist. |
LocalizedDescriptions |
Eine optionale Vorlagenbeschreibung, die entsprechend einem Gebietsschema lokalisiert ist. |
Anhang: SettingsLocationTemplate.xsd
Hier sehen Sie die Datei "SettingsLocationTemplate.xsd" mit ihren Elementen, untergeordneten Elementen, Attributen und Parametern:
<?xml version="1.0" encoding="utf-8"?>
<xs:schema id="UevSettingsLocationTemplate"
targetNamespace="https://schemas.microsoft.com/UserExperienceVirtualization/2013A/SettingsLocationTemplate"
elementFormDefault="qualified"
xmlns="https://schemas.microsoft.com/UserExperienceVirtualization/2013A/SettingsLocationTemplate"
xmlns:mstns="https://schemas.microsoft.com/UserExperienceVirtualization/2013A/SettingsLocationTemplate"
xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:simpleType name="Guid">
<xs:restriction base="xs:string">
<xs:pattern value="\{[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}\}" />
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="FilenameString">
<xs:restriction base="xs:string">
<xs:pattern value="[^\\\?\*\|<>/:]+" />
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="IDString">
<xs:restriction base="xs:string">
<xs:pattern value="[^\\\?\*\|<>/:.]+" />
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="CompositeIDString">
<xs:restriction base="xs:string">
<xs:pattern value="[^\\\?\*\|<>/:.]+([.][^\\\?\*\|<>/:.]+)?" />
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="TemplateVersion">
<xs:restriction base="xs:integer">
<xs:minInclusive value="0" />
<xs:maxInclusive value="2147483647" />
</xs:restriction>
</xs:simpleType>
<xs:complexType name="Empty">
<xs:sequence/>
</xs:complexType>
<xs:complexType name="LocalizedString">
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute name="Locale" type="xs:string" use="required"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:complexType name="LocalizedName">
<xs:sequence>
<xs:element name="Name" type="LocalizedString" minOccurs="1" maxOccurs="unbounded" />
</xs:sequence>
</xs:complexType>
<xs:complexType name="LocalizedDescription">
<xs:sequence>
<xs:element name="Description" type="LocalizedString" minOccurs="1" maxOccurs="unbounded" />
</xs:sequence>
</xs:complexType>
<xs:complexType name="ReplacedTemplates">
<xs:sequence>
<xs:element name="ID" type="CompositeIDString" minOccurs="1" maxOccurs="unbounded" />
</xs:sequence>
</xs:complexType>
<xs:complexType name="Author">
<xs:all>
<xs:element name="Name" type="xs:string" minOccurs="1" />
<xs:element name="Email" type="xs:string" minOccurs="0" />
</xs:all>
</xs:complexType>
<xs:complexType name="Range">
<xs:attribute name="Minimum" type="xs:integer" use="required"/>
<xs:attribute name="Maximum" type="xs:integer" use="required"/>
</xs:complexType>
<xs:complexType name="ProcessVersion">
<xs:sequence>
<xs:element name="Major" type="Range" minOccurs="1" />
<xs:element name="Minor" type="Range" minOccurs="0" />
<xs:element name="Build" type="Range" minOccurs="0" />
<xs:element name="Patch" type="Range" minOccurs="0" />
</xs:sequence>
</xs:complexType>
<xs:simpleType name="Architecture">
<xs:restriction base="xs:string">
<xs:enumeration value="Win32"/>
<xs:enumeration value="Win64"/>
</xs:restriction>
</xs:simpleType>
<xs:complexType name="Process">
<xs:sequence>
<xs:element name="Filename" type="FilenameString" minOccurs="1" />
<xs:element name="Architecture" type="Architecture" minOccurs="0" />
<xs:element name="ProductName" type="xs:string" minOccurs="0" />
<xs:element name="FileDescription" type="xs:string" minOccurs="0" />
<xs:element name="ProductVersion" type="ProcessVersion" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="FileVersion" type="ProcessVersion" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="Processes">
<xs:sequence>
<xs:choice minOccurs="1">
<xs:element name="Process" type="Process" />
<xs:element name="ShellProcess" type="Empty" />
</xs:choice>
<xs:element name="Process" type="Process" minOccurs="0" maxOccurs="unbounded" />
</xs:sequence>
</xs:complexType>
<xs:complexType name="Path">
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute name="Recursive" type="xs:boolean" default="false"/>
<xs:attribute name="DeleteIfNotFound" type="xs:boolean" default="false"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:complexType name="RegistrySetting">
<xs:sequence>
<xs:element name="Path" type="Path" />
<xs:element name="Name" type="xs:string" minOccurs="0" maxOccurs="unbounded" />
<xs:element name="Exclude" minOccurs="0" maxOccurs="unbounded">
<xs:complexType>
<xs:sequence>
<xs:element name="Path" type="Path" minOccurs="0" />
<xs:element name="Name" type="xs:string" minOccurs="0" maxOccurs="unbounded" />
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
<xs:complexType name="FileSetting">
<xs:sequence>
<xs:element name="Root">
<xs:complexType>
<xs:choice>
<xs:element name="KnownFolder" type="Guid" />
<xs:element name="RegistryEntry" type="xs:string" />
<xs:element name="EnvironmentVariable" type="xs:string" />
</xs:choice>
</xs:complexType>
</xs:element>
<xs:element name="Path" minOccurs="0" type="Path" />
<xs:element name="FileMask" type="xs:string" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="Exclude" minOccurs="0" maxOccurs="unbounded">
<xs:complexType>
<xs:sequence>
<xs:element name="Path" type="Path" minOccurs="0" />
<xs:element name="FileMask" type="xs:string" minOccurs="0" maxOccurs="unbounded" />
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
<xs:simpleType name="CustomActionSetting">
<xs:restriction base="xs:anyURI"/>
</xs:simpleType>
<xs:simpleType name="SystemParameterSetting">
<xs:restriction base="xs:string">
<!-- Accessibility parameters -->
<xs:enumeration value="AccessTimeout"/>
<xs:enumeration value="AudioDescription"/>
<xs:enumeration value="ClientAreaAnimation"/>
<xs:enumeration value="DisableOverlappedContent"/>
<xs:enumeration value="FilterKeys"/>
<xs:enumeration value="FocusBorderHeight"/>
<xs:enumeration value="FocusBorderWidth"/>
<xs:enumeration value="HighContrast"/>
<xs:enumeration value="MessageDuration"/>
<xs:enumeration value="MouseClickLock"/>
<xs:enumeration value="MouseClickLockTime"/>
<xs:enumeration value="MouseKeys"/>
<xs:enumeration value="MouseSonar"/>
<xs:enumeration value="MouseVanish"/>
<xs:enumeration value="ScreenReader"/>
<xs:enumeration value="ShowSounds"/>
<xs:enumeration value="SoundSentry"/>
<xs:enumeration value="StickyKeys"/>
<xs:enumeration value="ToggleKeys"/>
<!-- Input parameters -->
<xs:enumeration value="Beep"/>
<xs:enumeration value="BlockSendInputResets"/>
<xs:enumeration value="DefaultInputLang"/>
<xs:enumeration value="DoubleClickTime"/>
<xs:enumeration value="DoubleClkHeight"/>
<xs:enumeration value="DoubleClkWidth"/>
<xs:enumeration value="KeyboardCues"/>
<xs:enumeration value="KeyboardDelay"/>
<xs:enumeration value="KeyboardPref"/>
<xs:enumeration value="KeyboardSpeed"/>
<xs:enumeration value="Mouse"/>
<xs:enumeration value="MouseButtonSwap"/>
<xs:enumeration value="MouseHoverHeight"/>
<xs:enumeration value="MouseHoverTime"/>
<xs:enumeration value="MouseHoverWidth"/>
<xs:enumeration value="MouseSpeed"/>
<xs:enumeration value="MouseTrails"/>
<xs:enumeration value="SnapToDefButton"/>
<xs:enumeration value="WheelScrollChars"/>
<xs:enumeration value="WheelScrollLines"/>
<!-- Desktop parameters (limited subset) -->
<xs:enumeration value="DeskWallpaper"/>
<xs:enumeration value="DesktopColor"/>
</xs:restriction>
</xs:simpleType>
<xs:complexType name="Settings">
<xs:sequence>
<xs:element name="Asynchronous" type="xs:boolean" minOccurs="0" />
<xs:element name="PreventOverlappingSynchronization" type="xs:boolean" minOccurs="0" />
<xs:element name="AlwaysApplySettings" type="xs:boolean" minOccurs="0" />
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="Registry" type="RegistrySetting" />
<xs:element name="File" type="FileSetting" />
<xs:element name="SystemParameter" type="SystemParameterSetting" />
<xs:element name="CustomAction" type="CustomActionSetting" />
</xs:choice>
</xs:sequence>
</xs:complexType>
<xs:complexType name="Common">
<xs:sequence>
<xs:element name="Name" type="xs:string" />
<xs:element name="ID" type="IDString" />
<xs:element name="ReplacedTemplates" type="ReplacedTemplates" minOccurs="0" />
<xs:element name="Description" type="xs:string" minOccurs="0" />
<xs:element name="LocalizedNames" type="LocalizedName" minOccurs="0" />
<xs:element name="LocalizedDescriptions" type="LocalizedDescription" minOccurs="0" />
<xs:element name="Version" type="xs:integer" />
<xs:element name="DeferToMSAccount" type="Empty" minOccurs="0" />
<xs:element name="DeferToOffice365" type="Empty" minOccurs="0" />
<xs:element name="Settings" type="Settings" />
</xs:sequence>
</xs:complexType>
<xs:complexType name="Application">
<xs:sequence>
<xs:element name="Name" type="xs:string" />
<xs:element name="ID" type="IDString" />
<xs:element name="ReplacedTemplates" type="ReplacedTemplates" minOccurs="0" />
<xs:element name="Description" type="xs:string" minOccurs="0" />
<xs:element name="LocalizedNames" type="LocalizedName" minOccurs="0" />
<xs:element name="LocalizedDescriptions" type="LocalizedDescription" minOccurs="0" />
<xs:element name="Version" type="xs:integer" />
<xs:element name="DeferToMSAccount" type="Empty" minOccurs="0" />
<xs:element name="DeferToOffice365" type="Empty" minOccurs="0" />
<xs:element name="Processes" type="Processes" />
<xs:element name="Settings" type="Settings" />
</xs:sequence>
</xs:complexType>
<xs:element name="SettingsLocationTemplate">
<xs:complexType>
<xs:sequence>
<xs:element name="Name" type="xs:string" />
<xs:element name="ID" type="IDString" />
<xs:element name="Description" type="xs:string" minOccurs="0" />
<xs:element name="LocalizedNames" type="LocalizedName" minOccurs="0" />
<xs:element name="LocalizedDescriptions" type="LocalizedDescription" minOccurs="0" />
<xs:choice>
<!-- Single application -->
<xs:sequence>
<xs:element name="ReplacedTemplates" type="ReplacedTemplates" minOccurs="0" />
<xs:element name="Version" type="TemplateVersion" />
<xs:element name="Author" type="Author" minOccurs="0" />
<xs:element name="FixedProfile" type="xs:string" minOccurs="0" />
<xs:element name="DeferToMSAccount" type="Empty" minOccurs="0" />
<xs:element name="DeferToOffice365" type="Empty" minOccurs="0" />
<xs:element name="Processes" type="Processes" />
<xs:element name="Settings" type="Settings" />
</xs:sequence>
<!-- Suite of applications -->
<xs:sequence>
<xs:element name="ManageSuiteOnly" type="xs:boolean" minOccurs="0" />
<xs:element name="Author" type="Author" minOccurs="0" />
<xs:element name="FixedProfile" type="xs:string" minOccurs="0" />
<xs:element name="Common" type="Common" />
<xs:element name="Application" type="Application" minOccurs="2" maxOccurs="unbounded" />
</xs:sequence>
</xs:choice>
</xs:sequence>
</xs:complexType>
</xs:element>
<!-- SettingsLocationTemplate -->
</xs:schema>
Schemareferenz für UE-V 2.0-Anwendungsvorlagen
In diesem Thema wird die XML-Struktur der Einstellungsortvorlage von UE-V 2.0 erläutert. Außerdem sind Anleitungen zur Bearbeitung dieser Datei enthalten.
Inhalt dieses Abschnitts:
XML-Deklaration und Codierungsattribut
Namespace und Stammelement
Datentypen
Name-Element
ID-Element
Version-Element
Author-Element
Processes- und Process-Element
Application-Element
Common-Element
SettingsLocationTemplate-Element
Anhang: SettingsLocationTemplate.xsd
XML-Deklaration und Codierungsattribut
Obligatorisch: True
Typ: String
Die XML-Deklaration muss das Attribut für die XML-Version 1.0 angeben (<?xml version="1.0">). Vom UE-V Generator erstellte Einstellungsortvorlagen werden in UTF-8-Codierung gespeichert, obwohl die Codierung nicht explizit angegeben wird. Als bewährte Methode wird empfohlen, das Attribut für die UTF-8-Codierung (encoding="UTF-8") einzuschließen. In allen mit dem Produkt gelieferten Vorlagen ist dieses Tag ebenfalls angegeben (siehe Dokumente unter „%ProgramFiles%\Microsoft User Experience Virtualization\Templates“). Beispiel:
<?xml version="1.0" encoding="UTF-8"?>
Namespace und Stammelement
Obligatorisch: True
Typ: String
UE-V verwendet den Namespace "https://schemas.microsoft.com/UserExperienceVirtualization/2012/SettingsLocationTemplate" für alle Anwendungen. "SettingsLocationTemplate" ist das Stammelement und enthält alle anderen Elemente. Verweisen Sie in allen Vorlagen mit dem folgenden Tag auf "SettingsLocationTemplate":
<SettingsLocationTemplate xmlns='https://schemas.microsoft.com/UserExperienceVirtualization/2012/SettingsLocationTemplate'>
Datentypen
Es folgt eine Auflistung der Datentypen für das UE-V-Anwendungsvorlagenschema.
- GUID
"GUID" beschreibt einen standardmäßigen regulären Ausdruck für einen global eindeutigen Bezeichner in der Form "\{[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}\}". Dieser wird im Element "Filesetting\Root\KnownFolder" zum Überprüfen der Formatierung von bekannten Ordnern verwendet.
- FilenameString
"FilenameString" bezieht sich auf den Dateinamen eines zu überwachenden Prozesses. Die Werte sind durch den regulären Ausdruck [^\\\?\*\|<>/:]+ eingeschränkt (d. h., sie können keine umgekehrten Schrägstriche, Sternchen oder Fragezeichen, Platzhalterzeichen, senkrechten Striche, Größer- oder Kleiner-als-Zeichen, Schrägstriche oder Doppelpunkte enthalten).
- IDString
"IDString" bezieht sich auf den ID-Wert von Elementen des Typs "Application", "SettingsLocationTemplate" und Elemente vom Typ "Common" (werden zur Beschreibung von Anwendungssuites verwendet, die gemeinsame Einstellungen verwenden). Er ist durch den gleichen regulären Ausdruck wie "FilenameString" eingeschränkt ([^\\\?\*\|<>/:]+).
- TemplateVersion
"TemplateVersion" ist ein ganzzahliger Wert, der die Revision der Einstellungsortvorlage beschreibt. Der Wert kann zwischen 0 und 2147483647 liegen.
- Empty
"Empty" bezieht sich auf einen NULL-Wert. Dieser wird in "Process\ShellProcess" verwendet, um anzugeben, dass kein zu überwachender Prozess vorhanden ist. Dieser Wert sollte in keinen Anwendungsvorlagen verwendet werden.
- Author
Der Datentyp "Author" ist ein komplexer Typ, der den Autor einer Vorlage angibt. Er enthält zwei untergeordnete Elemente: Name und Email. Innerhalb des Datentyps "Author" ist das Element "Name" obligatorisch, während das Element "Email" optional ist. Dieser Typ ist unter dem Element "SettingsLocationTemplate" ausführlicher beschrieben.
- Range
"Range" definiert eine Ganzzahlklasse, die aus zwei untergeordneten Elementen besteht: Minimum und Maximum. Dieser Datentyp wird im Datentyp "ProcessVersion" implementiert. Wenn er angegeben wird, müssen die Werte "Minimum" und "Maximum" enthalten sein.
- ProcessVersion
"ProcessVersion" definiert einen Typ mit vier untergeordneten Elementen: Major, Minor, Build und Patch. Dieser Datentyp wird vom Element "Process" verwendet, um die Werte "ProductVersion" und "FileVersion" auszufüllen. Für diesen Typ wird ein Wert vom Typ "Range" angegeben. Das untergeordnete Element "Major" ist obligatorisch, die anderen Elemente sind optional.
- Architecture
"Architecture" listet zwei mögliche Werte auf: Win32 und Win64. Diese Werte werden zur Angabe der Prozessarchitektur verwendet.
Process
Der Datentyp "Process" ist ein Container, mit dem von UE-V zu überwachende Prozesse beschrieben werden. Er enthält sechs untergeordnete Elemente: Filename, Architecture, ProductName, FileDescription, ProductVersion und FileVersion. In der folgenden Tabelle ist der entsprechende Datentyp für jedes Element aufgeführt:Element Datentyp Obligatorisch Filename
FilenameString
True
Architecture
Architecture
False
ProductName
String
False
FileDescription
String
False
ProductVersion
ProcessVersion
False
FileVersion
ProcessVersion
False
- Processes
Der Datentyp "Processes" stellt einen Container für eine Sammlung von einem oder mehreren Elementen des Typs "Process" dar. Der Sequenztyp "Processes" unterstützt zwei untergeordnete Elemente: Process und ShellProcess. "Process" ist ein Element des Typs "Process" und "ShellProcess" ist vom Datentyp "Empty". Es muss mindestens ein Element in der Sequenz angegeben werden.
Path
"Path" wird von "RegistrySetting" und "FileSetting" zum Verweisen auf Registrierung und Dateipfade genutzt. Dieses Element unterstützt zwei optionale Attribute: Recursive und DeleteIfNotFound. Beide Werte werden auf den Standardwert "False" festgelegt (default="False")."Recursive" gibt an, dass der Pfad und alle Unterordner für Dateieinstellungen enthalten sind oder dass alle untergeordneten Registrierungsschlüssel für Registrierungseinstellungen enthalten sind. In beiden Fällen sind alle Elemente auf der aktuellen Ebene in den erfassten Daten enthalten. Bei einem Objekt des Typs "FileSettings" sind alle Dateien innerhalb des angegebenen Ordners in den von UE-V erfassten Daten enthalten, Ordner sind jedoch nicht eingeschlossen. Für Registrierungspfade werden alle Werte im aktuellen Pfad erfasst, untergeordnete Registrierungsschlüssel werden jedoch nicht erfasst. In beiden Fällen sollte darauf geachtet werden, eine Erfassung großer Datenmengen oder hoher Anzahlen von Elementen zu vermeiden.
Mit dem Attribut "DeleteIfNotFound" wird die Einstellung aus den Einstellungsspeicherpfaddaten des Benutzers entfernt. Dies kann in Fällen wünschenswert sein, in denen das Entfernen dieser Einstellungen aus dem Paket eine große Menge an Speicherplatz auf dem Einstellungsspeicherpfadserver spart.
- FileMask
"FileMask" gibt nur bestimmte Dateitypen für den Ordner an, der durch "Path" definiert ist. Beispielsweise kann "Path"C:\users\username\files
lauten und "FileMask" könnte mit*.txt
angegeben sein, um nur Textdateien einzuschließen.
- RegistrySetting
"RegistrySetting" stellt einen Container für Registrierungsschlüssel und Werte sowie das zugehörige gewünschte Verhalten von Seiten des UE-V-Agent dar. Innerhalb dieses Typs sind vier untergeordnete Elemente definiert: Path, Name, Exclude und eine Folge der Werte Path und Name.
- FileSetting
"FileSetting" enthält Parameter, die Dateien und Dateipfaden zugeordnet sind. Es sind vier untergeordnete Elemente definiert: Root, Path, FileMask und Exclude. "Root" ist obligatorisch, die anderen Elemente sind optional.
Settings
"Settings" ist ein Container für alle Einstellungen, die für eine bestimmte Vorlage gelten. Er enthält Instanzen der zuvor beschriebenen Einstellungen "Registry", "File", "SystemParameter" und "CustomAction". Darüber hinaus können auch die folgenden untergeordneten Elemente mit dem beschriebenen Verhalten enthalten sein:Element Beschreibung Asynchronous
Einstellungspakete vom Typ "Asynchronous" werden angewendet, ohne das Starten der Anwendung zu blockieren, sodass der Startvorgang der Anwendung fortgesetzt wird, während die Einstellungen noch angewendet werden. Dies ist im Fall von Einstellungen nützlich, die asynchron angewendet werden können, z. B. bei
get/set
über eine API, wie "SystemParameterSetting".PreventOverlappingSynchronization
In der Standardeinstellung speichert UE-V nur Einstellungen für eine Anwendung, wenn die letzte Instanz einer Anwendung, die die Vorlage verwendet, geschlossen wird. Wenn dieses Element auf "False" festgelegt ist, exportiert UE-V die Einstellungen auch dann, wenn andere Instanzen einer Anwendung ausgeführt werden. Geeignete Vorlagen (enthalten einen Elementabschnitt "Common"), die zum Lieferumfang von UE-V gehören, nutzen dieses Flag zum Aktivieren gemeinsam genutzter Einstellungen, sodass immer beim Schließen der Anwendung exportiert wird, während der Export anwendungsspezifischer Einstellungen bis zum Schließen der letzten Instanz verhindert wird.
Name-Element
Obligatorisch: True
Typ: String
"Name" gibt einen eindeutigen Namen für die Einstellungsortvorlage an. Dieser wird für Anzeigezwecken verwendet, wenn auf die Vorlage in WMI, PowerShell, der Ereignisanzeige und Debugprotokollen verwiesen wird. Vermeiden Sie allgemein Verweise auf Versionsinformationen, da diese aus dem Element "ProductVersion" entnommen werden können. Geben Sie z. B. <Name>My Application</Name>
statt <Name>My Application 1.1</Name>
an.
Hinweis
UE-V verweist nicht auf externe DTDs, und daher ist es nicht möglich, benannte Entitäten in einer Einstellungsortvorlage zu verwenden. Verwenden Sie beispielsweise nicht "&Reg;", um auf das Zeichen für eine eingetragene Marke ® zu verweisen. Verwenden Sie stattdessen kanonisch nummerierte Verweise, um diese Arten von Sonderzeichen aufzunehmen, z. B. "®" für das ®-Zeichen. Diese Regel gilt für alle Zeichenfolgenwerte in diesem Dokument.
Eine vollständige Liste der Zeichenentitäten finden Sie unter http://www.w3.org/TR/xhtml1/dtds.html. UTF-8-codierte Dokumente können direkt die Unicode-Zeichen enthalten. Beim Speichern von Vorlagen über den UE-V Generator werden Zeichenentitäten automatisch in die jeweiligen Unicode-Darstellungen konvertiert.ID-Element
Obligatorisch: True
Typ: String
"ID" gibt einen eindeutigen Bezeichner für eine bestimmte Vorlage an. Dieses Tag wird zum primären Bezeichner, den der UE-V-Agent verwendet, um zur Laufzeit auf die Vorlage zu verweisen (z. B. Anzeigen der Ausgabe der PowerShell-Cmdlets "Get-UevTemplate" und "Get-UevTemplateProgram"). Gemäß der Konvention sollte dieses Tag keine Leerzeichen enthalten, wodurch das Erstellen von Skripts vereinfacht wird. Versionsnummern von Anwendungen sollten in diesem Element zur leichteren Identifizierung der Vorlage angegeben werden, z. B. <ID>MicrosoftCalculator6</ID>
oder <ID>MicrosoftOffice2010Win64</ID>
.
Version-Element
Obligatorisch: True
Typ: Integer
Mindestwert: 0
Höchstwert: 2147483647
"Version" gibt die Version der Einstellungsortvorlage für das administrative Verfolgen von Änderungen an. Der UE-V Generator erhöht diese Zahl bei jedem Speichern der Vorlage automatisch um eins. Beachten Sie, dass dieses Feld eine Ganzzahl enthalten muss. Zahlen mit Dezimaltrennzeichen, wie z. B. <Version>2.5</Version>
, sind nicht zulässig.
Hinweis: Sie können Hinweise zu Versionsänderungen mithilfe von XML-Kommentartags <!-- -->
speichern. Beispiel:
<!--
Version History
Version 1 Jul 05, 2012 Initial template created by Generator - Denise@Contoso.com
Version 2 Jul 31, 2012 Added support for app.exe v2.1.3 - Mark@Contoso.com
Version 3 Jan 01, 2013 Added font settings support - Mark@Contoso.com
Version 4 Jan 31, 2013 Added support for plugin settings - Tony@Contoso.com
-->
<Version>4</Version>
Wichtig
Dieser Wert wird abgefragt, um festzustellen, ob eine neue Version einer Vorlage in folgenden Fällen auf eine vorhandene Vorlage angewendet werden soll:
- Wenn der geplante Task "Vorlage automatisch aktualisieren" ausgeführt wird.
- Wenn das PowerShell-Cmdlet "Update-UevTemplate" ausgeführt wird.
- Wenn die Aktualisierungsmethode "microsoft\uev:SettingsLocationTemplate" über WMI aufgerufen wird.
Author-Element
Obligatorisch: False
Typ: String
"Author" gibt den Ersteller der Einstellungsortvorlage an. Es werden zwei optionale untergeordnete Elemente unterstützt: Name und Email. Beide Attribute sind optional, doch wenn das untergeordnete Element "Email" angegeben wird, muss auch das Element "Name" angegeben werden. "Author" bezieht sich auf den vollständigen Namen des Kontakts für die Einstellungsortvorlage, und "Email" sollte auf eine E-Mail-Adresse für den Autor verweisen. Es wird empfohlen, diese Informationen in veröffentlichte Vorlagen einzuschließen, z. B. im UE-V-Vorlagenkatalog.
Processes- und Process-Element
Obligatorisch: True
Typ: Element
"Processes" enthält mindestens ein <Process>
-Element, das wiederum die folgenden untergeordneten Elemente enthält: Filename, Architecture, ProductName, FileDescription, ProductVersion und FileVersion. Das untergeordnete Element "Filename" ist obligatorisch, die anderen Elemente sind optional. Ein vollständig ausgefülltes Element enthält Tags, die dem folgenden Beispiel ähneln:
<Process>
<Filename>MyApplication.exe</Filename>
<Architecture>Win64</Architecture>
<ProductName> MyApplication </ProductName>
<FileDescription>MyApplication.exe</FileDescription>
<ProductVersion>
<Major Minimum="2" Maximum="2" />
<Minor Minimum="0" Maximum="0" />
<Build Minimum="0" Maximum="0" />
<Patch Minimum="5" Maximum="5" />
</ProductVersion>
<FileVersion>
<Major Minimum="2" Maximum="2" />
<Minor Minimum="0" Maximum="0" />
<Build Minimum="0" Maximum="0" />
<Patch Minimum="5" Maximum="5" />
</FileVersion>
</Process>
Filename
Obligatorisch: True
Typ: String
"Filename" bezieht sich auf den tatsächlichen Dateinamen der ausführbaren Datei, wie er im Dateisystem angezeigt wird. Dieses Element gibt das primäre Kriterium an, das von UE-V zur Auswertung verwendet wird, ob eine Vorlage auf einen Prozess angewendet wird oder nicht. Dieses Element muss in der XML-Datei der Einstellungsortvorlage angegeben sein.
Gültige Dateinamen dürfen dem regulären Ausdruck [^\\\?\*\|<>/:]+ nicht entsprechen. Das heißt, sie können keine umgekehrten Schrägstriche, Sternchen oder Fragezeichen, Platzhalterzeichen, senkrechten Striche, Größer- oder Kleiner-als-Zeichen, Schrägstriche oder Doppelpunkte (die Zeichen \ ? * | < > / oder :) enthalten.
Hinweis: Zum Testen einer Zeichenfolge anhand dieses regulären Ausdrucks verwenden Sie ein PowerShell-Befehlsfenster und ersetzen YourFileName durch den Namen der ausführbaren Datei:
"YourFileName.exe" -match "[\\\?\*\|<>/:]+"
Der Wert True gibt an, dass die Zeichenfolge unzulässige Zeichen enthält. Hier einige Beispiele für ungültige Werte:
\\server\share\program.exe
Program*.exe
Pro?ram.exe
Program<1>.exe
Hinweis
Der UE-V Generator codiert das Größer- und Kleiner-als-Zeichen als > bzw. <.
In seltenen Fällen enthält der Wert für "FileName" nicht zwangsläufig die Erweiterung ".exe", doch sollte sie als Teil des Werts angegeben werden. So sollte beispielsweise <Filename>MyApplictication.exe</Filename>
statt <Filename>MyApplictication</Filename>
angegeben werden. Im zweiten Beispiel wird die Vorlage nicht für den Prozess angewendet, wenn der tatsächliche Name der ausführbaren Datei "MyApplication.exe" lautet.
Architecture
Obligatorisch: False
Typ: Architecture (String)
"Architecture" bezieht sich auf die Prozessorarchitektur, für die die ausführbare Zieldatei kompiliert wurde. Gültige Werte sind "Win32" für 32-Bit-Anwendungen oder "Win64" für 64-Bit-Anwendung. Falls vorhanden, beschränkt dieses Tag die Anwendbarkeit der Einstellungsortvorlage auf eine bestimmte Anwendungsarchitektur. Als ein Beispiel dafür vergleichen Sie die Dateien "%ProgramFiles%\Microsoft User Experience Virtualization\templates\MicrosoftOffice2010Win32.xml" und "MicrosoftOffice2010Win64.xml", die in UE-V enthalten sind. Dies ist nützlich, wenn sich relative Pfade zwischen verschiedenen Versionen einer ausführbaren Datei ändern oder Einstellungen beim Wechsel von einer Prozessorarchitektur zu einer anderen hinzugefügt oder entfernt wurden.
Wenn dieses Element nicht vorhanden ist, wird die Architektur des Prozesses von der Einstellungsortvorlage ignoriert, und die Vorlage wird sowohl für 32- als auch 64-Bit-Prozesse angewendet, falls der Dateiname und andere Attribute zutreffen.
Hinweis
UE-V unterstützt in dieser Version keine ARM-Prozessoren.
ProductName
Obligatorisch: False
Typ: String
"ProductName" ist ein optionales Element, das zum Angeben eines Produkt zu administrativen oder Berichtszwecken verwendet wird. "ProductName" unterscheidet sich von "Filename" in der Hinsicht, dass keine Einschränkungen für reguläre Ausdrücke beim Wert bestehen. Dies ermöglicht besser verständliche Beschreibungen eines Prozesses, bei dem der Name der ausführbaren Datei möglicherweise nicht eindeutig ist. Beispiel:
<Process>
<Filename>MyApplication.exe</Filename>
<ProductName>My Application 6.x by Contoso.com</ProductName>
<ProductVersion>
<Major Minimum="6" Maximum="6" />
</ProductVersion>
</Process>
FileDescription
Obligatorisch: False
Typ: String
"FileDescription" ist ein optionales Tag, das eine administrative Beschreibung der ausführbaren Datei ermöglicht. Dies ist ein Freitextfeld und kann bei der Unterscheidung zwischen mehreren ausführbaren Dateien innerhalb eines Softwarepakets hilfreich sein, bei denen die Funktion der ausführbaren Datei zu erkennen sein muss.
Bei einer geeigneten Anwendung kann es z. B. nützlich sein, Erinnerungen zur Funktion von zwei ausführbaren Dateien ("MyApplication.exe" und "MyApplicationHelper.exe") bereitzustellen, wie es nachfolgend gezeigt ist:
<Processes>
<Process>
<Filename>MyApplication.exe</Filename>
<FileDescription>My Application Main Engine</ FileDescription>
<ProductVersion>
<Major Minimum="6" Maximum="6" />
</ProductVersion>
</Process>
<Process>
<Filename>MyApplicationHelper.exe</Filename>
<FileDescription>My Application Background Process Executable</FileDescription>
<ProductVersion>
<Major Minimum="6" Maximum="6" />
</ProductVersion>
</Process>
</Processes>
ProductVersion
Obligatorisch: False
Typ: String
"ProductVersion" bezieht sich auf die Haupt- und Nebenproduktversionen einer Datei sowie auf eine Build- und Patchebene. "ProductVersion" ist ein optionales Element, und wenn es angegeben wird, muss es mindestens das untergeordnete Element "Major" enthalten. Der Wert muss einen Bereich in der Form 'Minimum="X" Maximum="Y"' angeben, wobei X und Y ganze Zahlen sind. Die Werte "Minimum" und "Maximum" können identisch sein.
Die Elemente für die Produkt- und Dateiversion müssen nicht angegeben werden. Dadurch wird die Vorlage "versionsunabhängig", was bedeutet, dass die Vorlage für alle Versionen der angegebenen ausführbaren Datei angewendet wird.
Beispiel 1:
Bei Angabe der Produktversion 1.0 im UE-V Generator wird folgende XML erzeugt:
<ProductVersion>
<Major Minimum="1" Maximum="1" />
<Minor Minimum="0" Maximum="0" />
</ProductVersion>
Beispiel 2:
Bei Angabe der Dateiversion 5.0.2.1000 im UE-V Generator wird folgende XML erzeugt:
<FileVersion>
<Major Minimum="5" Maximum="5" />
<Minor Minimum="0" Maximum="0" />
<Build Minimum="2" Maximum="2" />
<Patch Minimum="1000" Maximum="1000" />
</FileVersion>
Beispiel 1 für eine falsche Angabe – unvollständiger Bereich:
Nur das Attribut "Minimum" ist vorhanden. Auch "Maximum" muss im Bereich angegeben werden.
<ProductVersion>
<Major Minimum="2" />
</ProductVersion>
Beispiel 2 für eine falsche Angabe – "Minor" ohne "Major" angegeben:
Nur das Element "Minor" ist vorhanden. Auch "Major" muss angegeben werden.
<ProductVersion>
<Minor Minimum="0" Maximum="0" />
</ProductVersion>
FileVersion
Obligatorisch: False
Typ: String
"FileVersion" unterscheidet zwischen der Releaseversion einer veröffentlichten Anwendung und den internen Builddetails der ausführbaren Datei einer Komponente. Bei den meisten kommerziellen Anwendungen sind diese Nummern identisch. In den Fällen, in denen sie sich unterscheiden, gibt die Produktversion einer Datei eine generische Versionskennung einer Datei an, während die Dateiversion einen bestimmten Build einer Datei angibt (z. B. im Fall eines Hotfixes oder Updates). Dadurch werden Dateien ohne Bruch der Erkennungslogik eindeutig identifiziert.
Um die Produktversion und Dateiversion einer bestimmten ausführbaren Datei zu ermitteln, klicken Sie in Windows-Explorer mit der rechten Maustaste auf die Datei, wählen Sie "Eigenschaften" aus, und klicken Sie dann auf die Registerkarte "Details".
Das Einschließen eines Elements vom Typ "FileVersion" für eine Anwendung ermöglicht eine präzisere Feinabstimmung der Erkennungslogik, ist aber bei den meisten Anwendungen nicht erforderlich. Die Einstellungen des Elements "ProductVersion" werden zuerst überprüft, und anschließend wird "FileVersion" geprüft. Die stärker einschränkende Einstellung wird angewendet.
Die untergeordneten Elemente und Syntaxregeln für "FileVersion" sind mit denen von "ProductVersion" identisch.
<Process>
<Filename>MSACCESS.EXE</Filename>
<Architecture>Win32</Architecture>
<ProductVersion>
<Major Minimum="14" Maximum="14" />
<Minor Minimum="0" Maximum="0" />
</ProductVersion>
<FileVersion>
<Major Minimum="14" Maximum="14" />
<Minor Minimum="0" Maximum="0" />
</FileVersion>
</Process>
Application-Element
"Application" ist ein Container für Einstellungen, die für eine bestimmte Anwendung gelten. Dabei handelt es sich um eine Sammlung der folgenden Felder/Typen.
Feld/Typ | Beschreibung |
---|---|
Name |
Gibt einen eindeutigen Namen für die Einstellungsortvorlage an. Dieser wird für Anzeigezwecken verwendet, wenn auf die Vorlage in WMI, PowerShell, der Ereignisanzeige und Debugprotokollen verwiesen wird. Weitere Informationen finden Sie unter Name-Element. |
ID |
Gibt einen eindeutigen Bezeichner für eine bestimmte Vorlage an. Dieses Tag wird zum primären Bezeichner, den der UE-V-Agent verwendet, um zur Laufzeit auf die Vorlage zu verweisen. Weitere Informationen finden Sie unter ID-Element. |
Beschreibung |
Eine optionale Beschreibung der Vorlage. |
LocalizedNames |
Ein optionaler Name, der auf der Benutzeroberfläche angezeigt wird und entsprechend einem Gebietsschema lokalisiert ist. |
LocalizedDescriptions |
Eine optionale Vorlagenbeschreibung, die entsprechend einem Gebietsschema lokalisiert ist. |
Version |
Gibt die Version der Einstellungsortvorlage für das administrative Verfolgen von Änderungen an. Weitere Informationen finden Sie unter Version-Element. |
DeferToMSAccount |
Steuert, ob diese Vorlage in Verbindung mit einem Microsoft-Konto aktiviert wird oder nicht. Wenn die MSA-Synchronisierung für einen Benutzer auf einem Computer aktiviert ist, wird diese Vorlage automatisch deaktiviert. |
DeferToOffice365 |
Ähnlich wie MSA steuert dies, ob diese Vorlage in Verbindung mit Office 365 aktiviert wird. Wenn Office 365 für das Synchronisieren von Einstellungen verwendet wird, wird diese Vorlage automatisch deaktiviert. |
Processes |
Ein Container für eine Sammlung von einem oder mehreren Elementen der Typs "Process". Weitere Informationen finden Sie unter Processes- und Process-Element. |
Settings |
Ein Container für alle Einstellungen, die für eine bestimmte Vorlage gelten. Er enthält Instanzen der Einstellungen "Registry", "File", "SystemParameter" und "CustomAction". Weitere Informationen finden Sie unter Settings im Abschnitt Datentypen. |
Common-Element
"Common" ähnelt einem Element vom Typ "Application", ist aber immer mindestens zwei Elementen vom Typ "Application" zugeordnet. Der Abschnitt "Common" stellt die Gruppe von Einstellungen dar, die von diesen Anwendungsinstanzen gemeinsam genutzt werden. Dabei handelt es sich um eine Sammlung der folgenden Felder/Typen.
Feld/Typ | Beschreibung |
---|---|
Name |
Gibt einen eindeutigen Namen für die Einstellungsortvorlage an. Dieser wird für Anzeigezwecken verwendet, wenn auf die Vorlage in WMI, PowerShell, der Ereignisanzeige und Debugprotokollen verwiesen wird. Weitere Informationen finden Sie unter Name-Element. |
ID |
Gibt einen eindeutigen Bezeichner für eine bestimmte Vorlage an. Dieses Tag wird zum primären Bezeichner, den der UE-V-Agent verwendet, um zur Laufzeit auf die Vorlage zu verweisen. Weitere Informationen finden Sie unter ID-Element. |
Beschreibung |
Eine optionale Beschreibung der Vorlage. |
LocalizedNames |
Ein optionaler Name, der auf der Benutzeroberfläche angezeigt wird und entsprechend einem Gebietsschema lokalisiert ist. |
LocalizedDescriptions |
Eine optionale Vorlagenbeschreibung, die entsprechend einem Gebietsschema lokalisiert ist. |
Version |
Gibt die Version der Einstellungsortvorlage für das administrative Verfolgen von Änderungen an. Weitere Informationen finden Sie unter Version-Element. |
DeferToMSAccount |
Steuert, ob diese Vorlage in Verbindung mit einem Microsoft-Konto aktiviert wird oder nicht. Wenn die MSA-Synchronisierung für einen Benutzer auf einem Computer aktiviert ist, wird diese Vorlage automatisch deaktiviert. |
DeferToOffice365 |
Ähnlich wie MSA steuert dies, ob diese Vorlage in Verbindung mit Office 365 aktiviert wird. Wenn Office 365 für das Synchronisieren von Einstellungen verwendet wird, wird diese Vorlage automatisch deaktiviert. |
Settings |
Ein Container für alle Einstellungen, die für eine bestimmte Vorlage gelten. Er enthält Instanzen der Einstellungen "Registry", "File", "SystemParameter" und "CustomAction". Weitere Informationen finden Sie unter Settings im Abschnitt Datentypen. |
SettingsLocationTemplate-Element
Dieses Element definiert die Einstellungen für eine einzelne Anwendung oder eine Suite von Anwendungen.
Feld/Typ | Beschreibung |
---|---|
Name |
Gibt einen eindeutigen Namen für die Einstellungsortvorlage an. Dieser wird für Anzeigezwecken verwendet, wenn auf die Vorlage in WMI, PowerShell, der Ereignisanzeige und Debugprotokollen verwiesen wird. Weitere Informationen finden Sie unter Name-Element. |
ID |
Gibt einen eindeutigen Bezeichner für eine bestimmte Vorlage an. Dieses Tag wird zum primären Bezeichner, den der UE-V-Agent verwendet, um zur Laufzeit auf die Vorlage zu verweisen. Weitere Informationen finden Sie unter ID-Element. |
Beschreibung |
Eine optionale Beschreibung der Vorlage. |
LocalizedNames |
Ein optionaler Name, der auf der Benutzeroberfläche angezeigt wird und entsprechend einem Gebietsschema lokalisiert ist. |
LocalizedDescriptions |
Eine optionale Vorlagenbeschreibung, die entsprechend einem Gebietsschema lokalisiert ist. |
Anhang: SettingsLocationTemplate.xsd
Hier sehen Sie die Datei "SettingsLocationTemplate.xsd" mit ihren Elementen, untergeordneten Elementen, Attributen und Parametern:
<?xml version="1.0" encoding="utf-8"?>
<xs:schema id="UevSettingsLocationTemplate"
targetNamespace="https://schemas.microsoft.com/UserExperienceVirtualization/2013/SettingsLocationTemplate"
elementFormDefault="qualified"
xmlns="https://schemas.microsoft.com/UserExperienceVirtualization/2013/SettingsLocationTemplate"
xmlns:mstns="https://schemas.microsoft.com/UserExperienceVirtualization/2013/SettingsLocationTemplate"
xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:simpleType name="Guid">
<xs:restriction base="xs:string">
<xs:pattern value="\{[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}\}" />
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="FilenameString">
<xs:restriction base="xs:string">
<xs:pattern value="[^\\\?\*\|<>/:]+" />
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="IDString">
<xs:restriction base="xs:string">
<xs:pattern value="[^\\\?\*\|<>/:.]+" />
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="TemplateVersion">
<xs:restriction base="xs:integer">
<xs:minInclusive value="0" />
<xs:maxInclusive value="2147483647" />
</xs:restriction>
</xs:simpleType>
<xs:complexType name="Empty">
<xs:sequence/>
</xs:complexType>
<xs:complexType name="LocalizedString">
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute name="Locale" type="xs:string" use="required"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:complexType name="LocalizedName">
<xs:sequence>
<xs:element name="Name" type="LocalizedString" minOccurs="1" maxOccurs="unbounded" />
</xs:sequence>
</xs:complexType>
<xs:complexType name="LocalizedDescription">
<xs:sequence>
<xs:element name="Description" type="LocalizedString" minOccurs="1" maxOccurs="unbounded" />
</xs:sequence>
</xs:complexType>
<xs:complexType name="Author">
<xs:all>
<xs:element name="Name" type="xs:string" minOccurs="1" />
<xs:element name="Email" type="xs:string" minOccurs="0" />
</xs:all>
</xs:complexType>
<xs:complexType name="Range">
<xs:attribute name="Minimum" type="xs:integer" use="required"/>
<xs:attribute name="Maximum" type="xs:integer" use="required"/>
</xs:complexType>
<xs:complexType name="ProcessVersion">
<xs:sequence>
<xs:element name="Major" type="Range" minOccurs="1" />
<xs:element name="Minor" type="Range" minOccurs="0" />
<xs:element name="Build" type="Range" minOccurs="0" />
<xs:element name="Patch" type="Range" minOccurs="0" />
</xs:sequence>
</xs:complexType>
<xs:simpleType name="Architecture">
<xs:restriction base="xs:string">
<xs:enumeration value="Win32"/>
<xs:enumeration value="Win64"/>
</xs:restriction>
</xs:simpleType>
<xs:complexType name="Process">
<xs:sequence>
<xs:element name="Filename" type="FilenameString" minOccurs="1" />
<xs:element name="Architecture" type="Architecture" minOccurs="0" />
<xs:element name="ProductName" type="xs:string" minOccurs="0" />
<xs:element name="FileDescription" type="xs:string" minOccurs="0" />
<xs:element name="ProductVersion" type="ProcessVersion" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="FileVersion" type="ProcessVersion" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="Processes">
<xs:sequence>
<xs:choice minOccurs="1">
<xs:element name="Process" type="Process" />
<xs:element name="ShellProcess" type="Empty" />
</xs:choice>
<xs:element name="Process" type="Process" minOccurs="0" maxOccurs="unbounded" />
</xs:sequence>
</xs:complexType>
<xs:complexType name="Path">
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute name="Recursive" type="xs:boolean" default="false"/>
<xs:attribute name="DeleteIfNotFound" type="xs:boolean" default="false"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:complexType name="RegistrySetting">
<xs:sequence>
<xs:element name="Path" type="Path" />
<xs:element name="Name" type="xs:string" minOccurs="0" maxOccurs="unbounded" />
<xs:element name="Exclude" minOccurs="0" maxOccurs="unbounded">
<xs:complexType>
<xs:sequence>
<xs:element name="Path" type="Path" minOccurs="0" />
<xs:element name="Name" type="xs:string" minOccurs="0" maxOccurs="unbounded" />
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
<xs:complexType name="FileSetting">
<xs:sequence>
<xs:element name="Root">
<xs:complexType>
<xs:choice>
<xs:element name="KnownFolder" type="Guid" />
<xs:element name="RegistryEntry" type="xs:string" />
<xs:element name="EnvironmentVariable" type="xs:string" />
</xs:choice>
</xs:complexType>
</xs:element>
<xs:element name="Path" minOccurs="0" type="Path" />
<xs:element name="FileMask" type="xs:string" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="Exclude" minOccurs="0" maxOccurs="unbounded">
<xs:complexType>
<xs:sequence>
<xs:element name="Path" type="Path" minOccurs="0" />
<xs:element name="FileMask" type="xs:string" minOccurs="0" maxOccurs="unbounded" />
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
<xs:simpleType name="SystemParameterSetting">
<xs:restriction base="xs:string">
<!-- Accessibility parameters -->
<xs:enumeration value="AccessTimeout"/>
<xs:enumeration value="AudioDescription"/>
<xs:enumeration value="ClientAreaAnimation"/>
<xs:enumeration value="DisableOverlappedContent"/>
<xs:enumeration value="FilterKeys"/>
<xs:enumeration value="FocusBorderHeight"/>
<xs:enumeration value="FocusBorderWidth"/>
<xs:enumeration value="HighContrast"/>
<xs:enumeration value="MessageDuration"/>
<xs:enumeration value="MouseClickLock"/>
<xs:enumeration value="MouseClickLockTime"/>
<xs:enumeration value="MouseKeys"/>
<xs:enumeration value="MouseSonar"/>
<xs:enumeration value="MouseVanish"/>
<xs:enumeration value="ScreenReader"/>
<xs:enumeration value="ShowSounds"/>
<xs:enumeration value="SoundSentry"/>
<xs:enumeration value="StickyKeys"/>
<xs:enumeration value="ToggleKeys"/>
<!-- Input parameters -->
<xs:enumeration value="Beep"/>
<xs:enumeration value="BlockSendInputResets"/>
<xs:enumeration value="DefaultInputLang"/>
<xs:enumeration value="DoubleClickTime"/>
<xs:enumeration value="DoubleClkHeight"/>
<xs:enumeration value="DoubleClkWidth"/>
<xs:enumeration value="KeyboardCues"/>
<xs:enumeration value="KeyboardDelay"/>
<xs:enumeration value="KeyboardPref"/>
<xs:enumeration value="KeyboardSpeed"/>
<xs:enumeration value="Mouse"/>
<xs:enumeration value="MouseButtonSwap"/>
<xs:enumeration value="MouseHoverHeight"/>
<xs:enumeration value="MouseHoverTime"/>
<xs:enumeration value="MouseHoverWidth"/>
<xs:enumeration value="MouseSpeed"/>
<xs:enumeration value="MouseTrails"/>
<xs:enumeration value="SnapToDefButton"/>
<xs:enumeration value="WheelScrollChars"/>
<xs:enumeration value="WheelScrollLines"/>
<!-- Desktop parameters (limited subset) -->
<xs:enumeration value="DeskWallpaper"/>
<xs:enumeration value="DesktopColor"/>
</xs:restriction>
</xs:simpleType>
<xs:complexType name="Settings">
<xs:sequence>
<xs:element name="Asynchronous" type="xs:boolean" minOccurs="0" />
<xs:element name="PreventOverlappingSynchronization" type="xs:boolean" minOccurs="0" />
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="Registry" type="RegistrySetting" />
<xs:element name="File" type="FileSetting" />
<xs:element name="SystemParameter" type="SystemParameterSetting" />
</xs:choice>
</xs:sequence>
</xs:complexType>
<xs:complexType name="Common">
<xs:sequence>
<xs:element name="Name" type="xs:string" />
<xs:element name="ID" type="IDString" />
<xs:element name="Description" type="xs:string" minOccurs="0" />
<xs:element name="LocalizedNames" type="LocalizedName" minOccurs="0" />
<xs:element name="LocalizedDescriptions" type="LocalizedDescription" minOccurs="0" />
<xs:element name="Version" type="xs:integer" />
<xs:element name="DeferToMSAccount" type="Empty" minOccurs="0" />
<xs:element name="Settings" type="Settings" />
</xs:sequence>
</xs:complexType>
<xs:complexType name="Application">
<xs:sequence>
<xs:element name="Name" type="xs:string" />
<xs:element name="ID" type="IDString" />
<xs:element name="Description" type="xs:string" minOccurs="0" />
<xs:element name="LocalizedNames" type="LocalizedName" minOccurs="0" />
<xs:element name="LocalizedDescriptions" type="LocalizedDescription" minOccurs="0" />
<xs:element name="Version" type="xs:integer" />
<xs:element name="DeferToMSAccount" type="Empty" minOccurs="0" />
<xs:element name="Processes" type="Processes" />
<xs:element name="Settings" type="Settings" />
</xs:sequence>
</xs:complexType>
<xs:element name="SettingsLocationTemplate">
<xs:complexType>
<xs:sequence>
<xs:element name="Name" type="xs:string" />
<xs:element name="ID" type="IDString" />
<xs:element name="Description" type="xs:string" minOccurs="0" />
<xs:element name="LocalizedNames" type="LocalizedName" minOccurs="0" />
<xs:element name="LocalizedDescriptions" type="LocalizedDescription" minOccurs="0" />
<xs:choice>
<!-- Single application -->
<xs:sequence>
<xs:element name="Version" type="TemplateVersion" />
<xs:element name="Author" type="Author" minOccurs="0" />
<xs:element name="DeferToMSAccount" type="Empty" minOccurs="0" />
<xs:element name="Processes" type="Processes" />
<xs:element name="Settings" type="Settings" />
</xs:sequence>
<!-- Suite of applications -->
<xs:sequence>
<xs:element name="ManageSuiteOnly" type="xs:boolean" minOccurs="0" />
<xs:element name="Author" type="Author" minOccurs="0" />
<xs:element name="Common" type="Common" />
<xs:element name="Application" type="Application" minOccurs="2" maxOccurs="unbounded" />
</xs:sequence>
</xs:choice>
</xs:sequence>
</xs:complexType>
</xs:element>
<!-- SettingsLocationTemplate -->
</xs:schema>
Haben Sie einen Vorschlag für UE-V?
Fügen Sie hier Vorschläge hinzu, oder stimmen Sie über Vorschläge ab. Verwenden Sie bei Problemen mit UE-V das UE-V-TechNet-Forum.
Siehe auch
Konzepte
Arbeiten mit benutzerdefinierten UE-V 2.x-Vorlagen und UE-V 2.x Generator