Struktur der Anwendungsdefinitionsdatei
Dieser Artikel beschreibt die XML-Struktur der Anwendungsdefinitionsdateien von Profile Management. Diese Struktur gilt sowohl für den Anwendungsprofiler als auch für plattformübergreifende Einstellungen.
Architekturdiagramm
-
XML-Deklaration und Kodierungsattribut
Die XML-Deklaration muss das Attribut <?xml version=”1.0”> angeben.
Encoding=”UTF-8” ist ein empfohlenes Attribut.
-
GroupDefinitions
Ein Container für Sammlungen von Gruppen. Er fungiert als Stammelement des XML-Dokuments. Seine Attribute umfassen Version und GUID. Dies sind obligatorische Attribute.
-
Group
Definiert Einstellungen einer Unteranwendung. Seine Attribute sind Name und GUID. Dies sind obligatorische Attribute.
-
Object
Definiert eine Einstellung einer Unteranwendung. Seine Attribute sind Name und GUID. Dies sind obligatorische Attribute.
-
Platform
Platform bietet verschiedene Definitionen in verschiedenen Betriebssystemen. Es kann ein optionales Attribut OSVersionNumber verwenden, um das Betriebssystem anzugeben. Wenn kein Attribut vorhanden ist, akzeptieren alle Plattformen die interne Definition der Einstellung. Platform muss eines der folgenden Elemente enthalten: RegKey, RegValue, File, Folder und Wallpaper.
-
RegKey
Definiert eine Einstellung als Schlüssel in der Registrierung. Es muss das Key-Element enthalten. Es enthält zwei optionale Unterelemente, Recurse und Merge. Recurse und Merge definieren die Leistung, wenn Profile Management den Schlüssel roamt. Ein weiteres optionales Unterelement ist ExcludeValues. ExcludeValues definiert die Registrierungswerte, die ausgeschlossen werden können.
-
RegValue
Definiert eine Einstellung als Wert in der Registrierung. Es muss Key enthalten, um den Pfad seines übergeordneten Schlüssels anzugeben.
-
Ordner
Definiert eine Einstellung als Ordner. Es muss Path enthalten, um den Pfad des Ordners anzugeben. Es hat optionale Unterelemente,
RecurseundMerge. Recurse und Merge definieren die Leistung, wenn Profile Management den Ordner roamt. Ein weiteres optionales Unterelement istExcludeFiles, das die Dateien definiert, die ausgeschlossen werden können. -
Datei
Definiert eine Einstellung als Datei. Es muss Path enthalten, um den Pfad des übergeordneten Ordners anzugeben, und
FileName, um den Namen einer Datei anzugeben. -
Hintergrundbild
Definiert alle Hintergrundbildeinstellungen. Es sind keine Attribute oder Unterelemente erforderlich. Profile Management roamt diese Einstellungen automatisch.
-
Schlüssel
Gibt den Pfad des Registrierungsschlüssels oder den Pfad des übergeordneten Registrierungsschlüssels an. Key ist das Unterelement von RegKey und RegValue.
-
ValueName
Gibt den Namen des Registrierungswerts an. Es ist ein Unterelement von RegValue.
-
Pfad
Gibt den Pfad des Ordners oder den Pfad des übergeordneten Ordners an. Es ist ein Unterelement von Folder und File. Profile Management-Variablen können übernommen werden.
-
Dateiname
Gibt den Namen einer Datei an. Es ist ein Unterelement von File.
-
Rekursion
Optionales Unterelement von RegKey und Folder. Wenn dieses Element vorhanden ist, durchsucht Profile Management den Schlüssel und den Ordner rekursiv.
-
Zusammenführen
Optionales Unterelement von RegKey und Folder. Wenn dieses Element vorhanden ist, führt Profile Management den Schlüssel und den Ordner zusammen (ersetzt sie aber nicht).
-
Ausschlusswerte
Optionales Unterelement von RegKey. Gibt die Werte an, die beim Roaming des Schlüssels ausgeschlossen werden können.
-
Ausschlussdateien
Optionales Unterelement von Folder. Gibt die Dateien an, die beim Roaming des Ordners ausgeschlossen werden können.
-
Ausschluss
Unterelement von ExcludeValues und ExcludeFiles. Gibt die ausgeschlossenen Elemente von Dateien oder Registrierungswerten an.
Hinweis
Stellen Sie sicher, dass Ihr Dokument ein korrektes Syntaxformat enthält. Profile Management überprüft diese Dateien beim Laden mithilfe der Validierungsdatei CPSValidationSchema.xsd. Die Validierungsdatei finden Sie unter dem Installationspfad von Profile Management. Profile Management ignoriert fehlerhafte Dateien und protokolliert Fehlermeldungen im Protokoll.
Beispiel
<?xml version="1.0" encoding="UTF-8"?>
<!-- Copyright 2011 Citrix Systems, Inc. All Rights Reserved. -->
<GroupDefinitions GUID="748E63D3-426E-4796-9C32-420B25DB2D9F" Version="4.0.0.0">
<!-- Application Settings -->
<Group GUID="0FCCCF29-0A0E-482d-A77E-3F39A8A854A6" Name="Application Settings">
<!-- Registry Key Setting Example -->
<Object GUID="637EC13C-2D47-4142-A8EB-3CEA6D53522A" Name="Software\Application\certain key">
<Platform>
<RegKey>
<Key>Software\Microsoft\Office\certain key</Key>
<Merge/>
<Recurse/>
<ExcludeValues>
<Exclude>excluded value 1</Exclude>
<Exclude>excluded value 2</Exclude>
<Exclude>excluded value 3</Exclude>
</ExcludeValues>
</RegKey>
</Platform>
</Object>
<!-- Registry Value Setting Example -->
<Object GUID="3C896310-10C4-4e5f-90C7-A79F4E653F81" Name="Software\Application\certain value">
<!-- Folder Setting Example -->
<Object GUID="7F8615D0-5E63-4bd0-982D-B7740559C6F9" Name="!CTX_ROAMINGAPPDATA!\Application\setting folder">
<Platform>
<Folder>
<!-- We can use Citrix variable if necessary -->
<Path>!CTX_ROAMINGAPPDATA!\Application\setting folder</Path>
<Merge/>
<Recurse/>
<ExcludeFiles>
<Exclude>excluded file 1</Exclude>
<Exclude>excluded file 2</Exclude>
<Exclude>excluded file 3</Exclude>
</ExcludeFiles>
</Folder>
</Platform>
</Object>
<!-- File Setting Example -->
<Object GUID="7F8615D0-5E63-4bd0-982D-B7740559C6F9" Name="!CTX_ROAMINGAPPDATA!\Application\file.txt">
<Platform>
<File>
<!-- We can use Citrix variable if necessary -->
<Path>!CTX_ROAMINGAPPDATA!\Application</Path>
<FileName>file.txt</FileName>
</File>
</Platform>
</Object>
<!-- Setting based on different OS -->
<Object GUID="1B43DE3F-EC9C-463c-AC19-CD01D00219B6" Name="!CTX_ROAMINGAPPDATA!\Application\%osname%\folder">
<!-- Assuming that the folder locates differently when in different platforms -->
<Platform OSVersionNumber="6.1">
<!-- Win7 -->
<Folder>
<Path>!CTX_ROAMINGAPPDATA!\Application\Win7\folder</Path>
<Recurse/>
</Folder>
</Platform>
<Platform OSVersionNumber="10.0">
<!-- Win10 -->
<Folder>
<Path>!CTX_ROAMINGAPPDATA!\Application\Win10\folder</Path>
<Recurse/>
</Folder>
</Platform>
</Object>
</Group>
</GroupDefinitions>