Freigeben über


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. "&#174" 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 &gt; bzw. &lt;.

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="[^\\\?\*\|&lt;&gt;/:]+" />
        </xs:restriction>
    </xs:simpleType>

    <xs:simpleType name="IDString">
        <xs:restriction base="xs:string">
            <xs:pattern value="[^\\\?\*\|&lt;&gt;/:.]+" />
        </xs:restriction>
    </xs:simpleType>

    <xs:simpleType name="CompositeIDString">
        <xs:restriction base="xs:string">
            <xs:pattern value="[^\\\?\*\|&lt;&gt;/:.]+([.][^\\\?\*\|&lt;&gt;/:.]+)?" />
        </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. "&#174" 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 &gt; bzw. &lt;.

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="[^\\\?\*\|&lt;&gt;/:]+" />
    </xs:restriction>
  </xs:simpleType>

  <xs:simpleType name="IDString">
    <xs:restriction base="xs:string">
      <xs:pattern value="[^\\\?\*\|&lt;&gt;/:.]+" />
    </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

Weitere Ressourcen

Technische Referenz zu UE-V 2.x