Beispiele für benutzerdefinierte XML-Dateien
Hinweis
Die Tabellen in diesem Thema sind sehr breit. Passen Sie die Fensterbreite bitte entsprechend an.
Inhalt dieses Themas
Beispiel 1: Migrieren einer nicht unterstützten App
Beispiel 2: Migrieren des Ordners „My Videos“
Beispiel 3: Migrieren von Dateien und Registrierungsschlüsseln
Beispiel 4: Migrieren bestimmter Ordner von verschiedenen Speicherorten
Beispiel 1: Migrieren einer nicht unterstützten App
Der folgende Code ist eine Vorlage für die Abschnitte, die Sie zum Migrieren Ihrer App benötigen. Für sich allein funktioniert die Vorlage nicht, Sie können sie aber verwenden, um eine eigene XML-Datei zu erstellen.
<migration urlid="https://www.microsoft.com/migration/1.0/migxmlext/migtestapp">
<component type="Application">
<!-- Name of the application -->
<displayName>Some Application</displayName>
<!-- Specify whether the environment variables exist in the context of user or system or both -->
<environment context="System">
<!-- Create the environment variables -->
<variable name="myVar1">
<!-- Simple text value assignment to a variable -->
<text>value</text>
</variable>
<variable name="myAppExePath">
<!-- Make a call to in-built helper function to get a value from a reg key and assign that value to the variable -->
<script>MigXMLHelper.GetStringContent("Registry","HKLM\Software\MyApp\Installer [EXEPATH]")</script>
</variable>
</environment>
<role role="Settings">
<detects>
<!-- All of these checks must be true for the component to be detected -->
<detect>
<!-- Make a call to in-built helper function to check if an object exists or not -->
<condition>MigXMLHelper.DoesObjectExist("Registry","HKLM\Software\MyApp [win32_version]")</condition>
</detect>
<detect>
<!-- Either of these checks must be true for the component to be detected -->
<!-- Make a call to in-built helper function to check if a file version matches or not -->
<condition>MigXMLHelper.DoesFileVersionMatch("%MyAppExePath%","ProductVersion","8.*")</condition>
<condition>MigXMLHelper.DoesFileVersionMatch("%MyAppExePath%","ProductVersion","9.*")</condition>
</detect>
</detects>
<!-- Describe the rules that will be executed during migration of this component and the context, whether user, system or both -->
<rules context="User">
<!-- Delete objects specified in the object set on the destination computer before applying source objects -->
<destinationCleanup>
<!-- Describe the pattern for the list of objects to be deleted -->
<objectSet>
<pattern type="Registry">HKCU\Software\MyApp\Toolbar\* [*]</pattern>
<pattern type="Registry">HKCU\Software\MyApp\ListView\* [*]</pattern>
<pattern type="Registry">HKCU\Software\MyApp [ShowTips]</pattern>
</objectSet>
</destinationCleanup>
<!-- Specify which set of objects should be migrated -->
<include>
<!-- Describe the pattern for the list of objects to be included -->
<objectSet>
<pattern type="Registry">HKCU\Software\MyApp\Toolbar\* [*]</pattern>
<pattern type="Registry">HKCU\Software\MyApp\ListView\* [*]</pattern>
<pattern type="Registry">HKCU\Software\MyApp [ShowTips]</pattern>
</objectSet>
</include>
<!-- Specify which set of objects should not be migrated -->
<exclude>
<!-- Describe the pattern for the list of objects to be excluded from migration -->
<objectSet>
<pattern type="Registry">HKCU\Software\MyApp [Display]</pattern>
</objectSet>
</exclude>
</rules>
</role>
</component>
</migration>
Beispiel 2: Migrieren des Ordners „My Videos“
Das folgende Beispiel zeigt eine benutzerdefinierte XML-Datei mit dem Namen „CustomFile.xml“, die „My Videos“ für alle Benutzer migriert, wenn der Ordner auf dem Quell-PC vorhanden ist.
| Code | Verhalten |
|---|---|
|
Überprüft, ob „My Videos“ auf dem Quell-PC vorhanden ist. |
|
Filtert die Verknüpfungen in „My Videos“ heraus, die auf dem Ziel-PC nicht aufgelöst werden können. Dies hat keinen Einfluss auf Dateien, bei denen es sich nicht um Verknüpfungen handelt. Wenn der Ordner „My Videos“ auf dem Quell-PC z. B. eine Verknüpfung enthält, die auf „C:\Ordner1“ verweist, wird diese Verknüpfung nur migriert, wenn „C:\Ordner1“ auf dem Ziel-PC vorhanden ist. Alle anderen Dateien (z. B. MP3-Dateien) werden ohne Filterung migriert. |
|
Migriert „My Videos“ für alle Benutzer. |
<?xml version="1.0" encoding="UTF-8"?>
<migration urlid="https://www.microsoft.com/migration/1.0/migxmlext/CustomFile">
<component type="Documents" context="User">
<displayName>My Video</displayName>
<role role="Data">
<detects>
<detect>
<condition>MigXmlHelper.DoesObjectExist("File","%CSIDL_MYVIDEO%")</condition>
</detect>
</detects>
<rules>
<include filter='MigXmlHelper.IgnoreIrrelevantLinks()'>
<objectSet>
<pattern type="File">%CSIDL_MYVIDEO%\* [*]</pattern>
</objectSet>
</include>
</rules>
</role>
</component>
</migration>
Beispiel 3: Migrieren von Dateien und Registrierungsschlüsseln
In dieser Tabelle wird das Verhalten in der folgenden XML-Beispieldatei beschrieben.
| Code | Verhalten |
|---|---|
|
Migriert alle Instanzen der Datei „Usmttestfile.txt“ aus allen Unterverzeichnissen von „%ProgramFiles%\USMTTestFolder“. |
|
Migriert das gesamte Verzeichnis unter „%ProgramFiles%\USMTDIRTestFolder“. |
|
Migriert alle Instanzen von „MyKey“ unter „HKCU\Software\USMTTESTKEY“. |
|
Migriert die gesamte Registrierungsstruktur unter „HKLM\Software\USMTTESTKEY“. |
<migration urlid="https://www.microsoft.com/migration/1.0/migxmlext/testfilemig">
<component type="Application" context="System">
<displayName>File Migration Test</displayName>
<role role="Data">
<rules context="System">
<include>
<objectSet>
<pattern type="File">%ProgramFiles%\USMTTestFolder\* [USMTTestFile.txt]</pattern><pattern type="File">%ProgramFiles%\USMTDIRTestFolder\* [*]</pattern>
</objectSet>
</include>
</rules>
</role>
</component>
<component type="System">
<displayName>Registry Migration Test</displayName>
<role role="Settings">
<rules context="UserAndSystem">
<include>
<objectSet>
<pattern type="Registry">HKCU\Software\USMTTESTKEY\* [MyKey]</pattern>
<pattern type="Registry">HKLM\Software\USMTTESTKEY\* [*]</pattern>
</objectSet>
</include>
</rules>
</role>
</component>
</migration>
Beispiel 4: Migrieren bestimmter Ordner von verschiedenen Speicherorten
Das Verhalten dieser benutzerdefinierten XML-Datei wird in den <displayName>-Kennzeichen im Code erläutert.
<migration urlid="https://www.microsoft.com/migration/1.0/migxmlext/test">
<component type="Documents" context="System">
<displayName>Component to migrate all Engineering Drafts subfolders without documents in this folder </displayName>
<role role="Data">
<rules>
<include>
<objectSet>
<pattern type="File"> C:\EngineeringDrafts\* [*]</pattern>
</objectSet>
</include>
<exclude>
<objectSet>
<pattern type="File"> C:\EngineeringDrafts\ [*]</pattern>
</objectSet>
</exclude>
</rules>
</role>
</component>
<component type="Documents" context="System">
<displayName>Component to migrate all user documents except Sample.doc</displayName>
<role role="Data">
<rules>
<include>
<objectSet>
<pattern type="File"> C:\UserDocuments\* [*]</pattern>
</objectSet>
</include>
<exclude>
<objectSet>
<pattern type="File"> C:\UserDocuments\ [Sample.doc]</pattern>
</objectSet>
</exclude>
</rules>
</role>
</component>
<component type="Documents" context="System">
<displayName>Component to migrate all Requests folders on any drive on the computer </displayName>
<role role="Data">
<rules>
<include>
<objectSet>
<script>MigXmlHelper.GenerateDrivePatterns ("\Requests\* [*] ", "Fixed")</script>
<script>MigXmlHelper.GenerateDrivePatterns ("*\Requests\* [*] ", "Fixed")</script>
</objectSet>
</include>
</rules>
</role>
</component>
<component type="Documents" context="System">
<displayName>Component to migrate all Presentations folder from any location on the C: drive </displayName>
<role role="Data">
<rules>
<include>
<objectSet>
<pattern type="File"> C:\*\Presentations\* [*]</pattern>
<pattern type="File"> C:\Presentations\* [*]</pattern>
</objectSet>
</include>
</rules>
</role>
</component>
</migration>