Grundlegendes zu XML-Migrationsdateien

Sie können das Verhalten einer einfachen Migration mit User State Migration Tool (USMT) 5.0 mithilfe von XML-Dateien ändern. Diese Dateien enthalten Anweisungen dazu, wo und wie die USMT-Tools Dateien und Einstellungen sammeln und anwenden sollen. USMT enthält drei XML-Dateien, mit denen Sie eine einfache Migration anpassen können: die Dateien „MigDocs.xml“ und „MigUser.xml“, die ändern, wie Dateien auf dem Quell-PC gefunden werden, und die Datei „MigApps.xml“, die zum Migrieren unterstützter App-Einstellungen erforderlich ist. Sie können auch benutzerdefinierte XML-Dateien und eine Datei „Config.xml“ erstellen und bearbeiten, um die Migration zusätzlich anzupassen.

Dieses Thema bietet eine Übersicht über die standardmäßigen und benutzerdefinierte XML-Migrationsdateien und enthält Richtlinien für das Erstellen und Bearbeiten einer angepassten Version der Datei „MigDocs.xml“. In der Datei „MigDocs.xml“ wird die neue GenerateDocPatterns-Funktion von USMT verwendet, um automatisch nach Benutzerdokumenten auf einem Quell-PC zu suchen.

Inhalt dieses Themas

Übersicht über die Datei „Config.xml“

Übersicht über die Datei „MigApp.xml“

Übersicht über die Datei „MigDocs.xml“

Übersicht über die Datei „MigUser.xml“

Verwenden mehrerer XML-Dateien

XML-Regeln für das Migrieren von Benutzerdateien

Erstellen und Bearbeiten einer benutzerdefinierten XML-Datei

GenerateDocPatterns-Funktion

Grundlegendes zum System- und Benutzerkontext

Beispielmigrationsregeln für angepasste Versionen von XML-Dateien

Verwendungsbeispiele für Exclude-Regeln

Verwendungsbeispiele für Include-Regeln

Nächste Schritte

Übersicht über die Datei „Config.xml“

Die Datei „Config.xml“ ist die Konfigurationsdatei, die mit der Option /genconfig des Tools ScanState erstellt wird. Sie kann verwendet werden, um die von USMT migrierten Betriebssystemkomponenten zu ändern. Die Datei „Config.xml“ kann wie im folgenden Beispiel dargestellt zusammen mit anderen XML-Dateien verwendet werden: scanstate /i:migapps.xml /i:migdocs.xml /genconfig:c:\myFolder\config.xml. Wenn Sie die Datei „Config.xml“ auf diese Weise verwenden, können Sie die Migration – einschließlich Benutzerprofile, -daten und -einstellungen – präzise steuern, ohne andere XML-Dateien zu ändern oder zu erstellen. Weitere Informationen zur Datei „Config.xml“ finden Sie unter Anpassen von USMT-XML-Dateien und Datei „Config.xml“.

Übersicht über die Datei „MigApp.xml“

Die zusammen mit USMT installierte Datei „MigApp.xml“ enthält Anweisungen zur Migration der Einstellungen für die unter Was wird von USMT migriert? aufgeführten Apps. Um App-Einstellungen zu migrieren, müssen Sie die Datei „MigApp.xml“ beim Ausführen von ScanState und LoadState mit der Option /i angeben. Die Dateien „MigDocs.xml“ und „MigUser.xml“ migrieren keine App-Einstellungen. Sie können eine benutzerdefinierte XML-Datei erstellen, um zusätzliche Apps einzuschließen. Weitere Informationen finden Sie unter Anpassen von USMT-XML-Dateien.

Übersicht über die Datei „MigDocs.xml“

In der Datei „MigDocs.xml“ wird die neue GenerateDocPatterns-Hilfsfunktion verwendet. Diese Funktion erstellt Anweisungen für USMT, mit denen Dateien auf Grundlage des Dateispeicherorts vom Quell-PC migriert werden können. Sie können die Datei „MigDocs.xml“ mit ScanState und LoadState verwenden, um eine gezieltere Migration durchzuführen als dies bei Verwendung von USMT ohne XML-Anweisungen möglich ist.

Die standardmäßige Datei „MigDocs.xml“ migriert Folgendes:

• Alle Dateien im Stamm des Laufwerks mit Ausnahme von%WINDIR%, %PROGRAMFILES%, %PROGRAMDATA% oder %USERS%

• Alle Ordner im Stammverzeichnis aller lokalen Festplattenlaufwerke, z. B. „c:\data_mail\*[*]“

• Alle Dateien im Stamm des Ordners „Profile“ mit Ausnahme von Dateien im Systemprofil, z. B. „c:\users\name[mail.pst]“

• Alle Ordner im Stamm des Ordners „Profile“ mit Ausnahme von Systemprofilordnern, z. B. „c:\users\name\new folder\*[*]“

• Standardmäßige freigegebene Ordner:

  • CSIDL_COMMON_DESKTOPDIRECTORY

  • CSIDL_COMMON_FAVORITES

  • CSIDL_COMMON_DOCUMENTS

  • CSIDL_COMMON_MUSIC

  • CSIDL_COMMON_PICTURES

  • CSIDL_COMMON_VIDEO

  • FOLDERID_PublicDownloads

• Standardmäßige Benutzerprofilordner für jeden Benutzer:

  • CSIDL_MYDOCUMENTS

  • CSIDL_MYPICTURES

  • FOLDERID_OriginalImages

  • CSIDL_MYMUSIC

  • CSIDL_MYVIDEO

  • CSIDL_FAVORITES

  • CSIDL_DESKTOP

  • CSIDL_QUICKLAUNCH

  • FOLDERID_Contacts

  • FOLDERID_Libraries

  • FOLDERID_Downloads

  • FOLDERID_SavedGames

  • FOLDERID_RecordedTV

Die standardmäßige Datei „MigDocs.xml“ migriert Folgendes nicht:

• Dateien, die sowohl mit dem hidden- als auch dem system-Attribut gekennzeichnet sind

• Dateien und Ordner auf Wechseldatenträgern

• Daten aus den Ordnern %WINDIR%, %PROGRAMDATA% und %PROGRAMFILES%

• Ordner, die installierte Apps enthalten

Sie können auch die Option /genmigxml mit ScanState verwenden, um die migrierten Dateien zu überprüfen und zu ändern. Weitere Informationen finden Sie im Abschnitt Erstellen und Bearbeiten einer benutzerdefinierten XML-Datei dieses Dokuments.

Übersicht über die Datei „MigUser.xml“

Die Datei „MigUser.xml“ enthält Anweisungen für USMT, mit denen Benutzerdateien auf Grundlage von Dateinamenerweiterungen migriert werden können. Sie können die Datei „MigUser.xml“ mit ScanState und LoadState verwenden, um eine gezieltere Migration durchzuführen als dies bei Verwendung von USMT ohne XML-Anweisungen möglich ist. Die Datei „MigUser.xml“ sammelt alle Dateien aus den standardmäßigen Benutzerprofilordnern sowie alle Dateien mit den angegebenen Dateinamenerweiterungen auf dem PC.

Die standardmäßige Datei „MigUser.xml“ migriert Folgendes:

• Alle Dateien aus den standardmäßigen Benutzerprofilordnern:

  • CSIDL_MYVIDEO

  • CSIDL_MYMUSIC

  • CSIDL_DESKTOP

  • CSIDL_STARTMENU

  • CSIDL_PERSONAL

  • CSIDL_MYPICTURES

  • CSIDL_FAVORITES

  • CSIDL_QUICK LAUNCH

• Dateien mit den folgenden Dateinamenerweiterungen:

  .qdf, .qsd, .qel, .qph, .doc*, .dot*, .rtf, .mcw, .wps, .scd, .wri, .wpd, .xl*, .csv, .iqy, .dqy, .oqy, .rqy, .wk*, .wq1, .slk, .dif, .ppt*, .pps*, .pot*, .sh3, .ch3, .pre, .ppa, .txt, .pst, .one*, .vl*, .vsd, .mpp, .or6, .accdb, .mdb, .pub

Die standardmäßige Datei „MigUser.xml“ migriert Folgendes nicht:

• Dateien, die sowohl mit dem hidden- als auch dem system-Attribut gekennzeichnet sind

• Dateien und Ordner auf Wechseldatenträgern

• Daten aus den Ordnern %WINDIR%, %PROGRAMFILES%, %PROGRAMDATA%

• Zugriffssteuerungslisten für Dateien in Ordnern außerhalb des Benutzerprofils.

Sie können eine Kopie der Datei „MigUser.xml“ erstellen und ändern, um standardmäßige Benutzerprofilordner und Dateinamenerweiterungen ein- oder auszuschließen. Wenn Sie die Erweiterungen aller Dateien kennen, die Sie vom Quell-PC migrieren möchten, verwenden Sie die Datei „MigUser.xml“, um alle relevanten Daten unabhängig vom Speicherort der Dateien zu verschieben. Dies kann allerdings dazu führen, dass die Migration mehr Dateien enthält als beabsichtigt. Wenn Sie sich z. B. entscheiden, alle JPG-Dateien zu migrieren, werden möglicherweise Bilddateien wie Miniaturansichten und Logos von Vorgänger-Apps migriert, die auf dem Quell-PC installiert sind.

Verwenden mehrerer XML-Dateien

Sie können mehrere XML-Dateien mit ScanState und LoadState verwenden. Jede der in USMT enthaltenen oder mit USMT erstellten standardmäßigen XML-Dateien ist für eine bestimmte Komponente der Migration konfiguriert. Sie können auch benutzerdefinierte XML-Dateien verwenden, um die Standarddateien durch zusätzliche Migrationsregeln zu ergänzen.

Sie können z. B. wie im folgenden Beispiel gezeigt alle XML-Migrationsdateitypen für eine einzige Migration verwenden:

Scanstate <store> /config:c:\myFolder\config.xml /i:migapps.xml /i:migdocs.xml /i:customrules.xml

XML-Regeln für das Migrieren von Benutzerdateien

Falls Ihr Dataset unbekannt ist oder viele Dateien außerhalb der standardmäßigen Benutzerprofilordner gespeichert sind, ist die Datei „MigDocs.xml“ der Datei „MigUser.xml“ vorzuziehen, da sie umfassendere Daten sammelt. Die Datei „MigDocs.xml“ migriert Datenordner basierend auf dem Speicherort. Die Datei „MigUser.xml“ migriert nur die Dateien, deren Dateinamenerweiterungen angegeben werden.

Falls Sie die Migration präziser steuern möchten, können Sie benutzerdefinierte XML-Dateien erstellen. Weitere Informationen finden Sie im Abschnitt Erstellen und Bearbeiten einer benutzerdefinierten XML-Datei dieses Dokuments.

Erstellen und Bearbeiten einer benutzerdefinierten XML-Datei

Sie können die Befehlszeilenoption /genmigxml verwenden, um zu bestimmen, welche Dateien in die Migration einbezogen werden und ob Änderungen notwendig sind. Die Option /genmigxml erstellt eine Datei an einem von Ihnen angegebenen Speicherort, sodass Sie die XML-Regeln überprüfen und bei Bedarf Änderungen vornehmen können.

So generieren Sie die XML-Migrationregeldatei für einen Quell-PC

1. Klicken Sie auf Start, auf Alle Programme und auf Zubehör, klicken Sie mit der rechten Maustaste auf Eingabeaufforderung, und klicken Sie anschließend auf Ausführen als.

2. Wählen Sie ein Konto mit Administratorrechten aus, geben Sie ein Kennwort an, und klicken Sie dann auf OK.

3. Geben Sie an der Eingabeaufforderung Folgendes ein:

   cd /d <USMTpath>
   
   scanstate.exe /genmigxml: <filepath.xml>
   

   Dabei ist <USMTpath> der Speicherort auf dem Quell-PC, an dem Sie die USMT-Dateien und -Tools gespeichert haben, und <filepath.xml> der vollständige Pfad zu einer Datei, in der Sie den Bericht speichern können. Geben Sie z. B. Folgendes ein:

   cd /d c:\USMT
   
   scanstate.exe /genmigxml:"C:\Documents and Settings\USMT Tester\Desktop\genMig.xml"
   

GenerateDocPatterns-Funktion

Die Datei „MigDocs.xml“ ruft die GenerateDocPatterns-Funktion auf, für die drei boolesche Werte angegeben werden können. Sie können die Einstellungen ändern, um festzulegen, wie die Datei „MigDocs.xml“ die XML-Regeln für die Migration generiert.

<pattern type="File">C:\Program Files\Microsoft Office\*[*.doc]</pattern>

Syntax:

MigXmlHelper.GenerateDocPatterns ("<ScanProgramFiles>", "<IncludePatterns>", "<SystemDrive>")

So erstellen Sie Include-Datenmuster nur für das Systemlaufwerk

<include filter='MigXmlHelper.IgnoreIrrelevantLinks()'>

     <objectSet>

        <script>MigXmlHelper.GenerateDocPatterns ("FALSE","TRUE","TRUE")</script>

     </objectSet>

</include>

So erstellen Sie eine Include-Regel, um Dateien für registrierte Dateinamenerweiterungen im Verzeichnis %PROGRAMFILES% zu sammeln

<include filter='MigXmlHelper.IgnoreIrrelevantLinks()'>

     <objectSet>

        <script>MigXmlHelper.GenerateDocPatterns ("TRUE","TRUE","FALSE")</script>

     </objectSet>

</include>

So erstellen Sie Exclude-Datenmuster

<exclude filter='MigXmlHelper.IgnoreIrrelevantLinks()'>

     <objectSet>

        <script>MigXmlHelper.GenerateDocPatterns ("FALSE","FALSE","FALSE")</script>

     </objectSet>

</exclude>

Grundlegendes zum System- und Benutzerkontext

Die XML-Migrationsdateien enthalten zwei <component>-Elemente mit unterschiedlichen context-Einstellungen. Der Systemkontext gilt für Dateien auf dem PC, die nicht im Verzeichnis „Benutzerprofile“ gespeichert sind, während der Benutzerkontext für Dateien eines einzelnen Benutzers gilt.

Systemkontext

Der Systemkontext beinhaltet Regeln für Daten außerhalb des Verzeichnisses „Benutzerprofile“. Wird z. B. die Datei „MigDocs.xml“ im Systemkontext aufgerufen, erstellt die GenerateDocPatterns-Funktion Muster für alle gemeinsamen Shellordner, Dateien im Stammverzeichnis der Festplattenlaufwerke und Ordner im Stamm der Festplattenlaufwerke. Die folgenden Ordner werden eingeschlossen:

• CSIDL_COMMON_DESKTOPDIRECTORY

• CSIDL_COMMON_FAVORITES

• CSIDL_COMMON_DOCUMENTS

• CSIDL_COMMON_MUSIC

• CSIDL_COMMON_PICTURES

• CSIDL_COMMON_VIDEO

• FOLDERID_PublicDownloads

Benutzerkontext

Der Benutzerkontext beinhaltet Regeln für Daten im Verzeichnis „Benutzerprofile“. Wird z. B. die Datei „MigDocs.xml“ im Benutzerkontext aufgerufen, erstellt die GenerateDocPatterns-Funktion Muster für alle Benutzershellordner, Dateien im Stamm des Profils und Ordner im Stamm des Profils. Die folgenden Ordner werden eingeschlossen:

• CSIDL_MYDOCUMENTS

• CSIDL_MYPICTURES

• FOLDERID_OriginalImages

• CSIDL_MYMUSIC

• CSIDL_MYVIDEO

• CSIDL_FAVORITES

• CSIDL_DESKTOP

• CSIDL_QUICKLAUNCH

• FOLDERID_Contacts

• FOLDERID_Libraries

• FOLDERID_Downloads

• FOLDERID_SavedGames

• FOLDERID_RecordedTV

Beispielmigrationsregeln für angepasste Versionen von XML-Dateien

Verwendungsbeispiele für Exclude-Regeln

In den folgenden Beispielen ist auf dem Quell-PC eine TXT-Datei namens „new text document“ in einem Verzeichnis namens „new folder“ vorhanden. Die standardmäßige Datei „MigDocs.xml“ migriert die Datei „new text document“ und alle Dateien im Verzeichnis „new folder“. Die Funktion erstellt folgende Regeln:

<pattern type="File">d:\new folder\[new text document.txt]</pattern>

<pattern type="File">d:\new folder\*[*]</pattern>

Um sowohl die Datei „new text document.txt“ als auch alle TXT-Dateien in „new folder“ auszuschließen, können Sie wie folgt vorgehen:

Beispiel 1: Ausschließen aller TXT-Dateien in einem Ordner

Um Regel 1 auszuschließen, ist eine genaue Übereinstimmung mit dem Dateinamen erforderlich. Für Regel 2 können Sie aber ein Muster erstellen, um Dateien anhand der Dateinamenerweiterung auszuschließen.

<exclude>

     <objectSet>

        <pattern type="File">D:\Newfolder\[new text document.txt]</pattern>

         <pattern type="File">D:\New folder\*[*.txt]</pattern>

     </objectSet>

</exclude>

Beispiel 2: Verwenden des UnconditionalExclude-Elements, um einer Regel Vorrang vor Include-Regeln zu geben

Wenn Sie den Namen oder Speicherort der Datei nicht kennen, Ihnen aber die Dateinamenerweiterung bekannt ist, können Sie die GenerateDrivePatterns-Funktion verwenden. Da die Regel aber weniger spezifisch ist als die von der Datei „MigDocs.xml“ generierte standardmäßige Include-Regel, hat sie keinen Vorrang. Sie müssen das <UnconditionalExclude>-Element verwenden, um dieser Regel Vorrang vor der standardmäßigen Include-Regel zu geben. Weitere Informationen zur Rangfolge von XML-Migrationsregeln finden Sie unter Konflikte und Rangfolge.

<unconditionalExclude>

     <objectSet>

        <script>MigXmlHelper.GenerateDrivePatterns ("*[*.txt]", "Fixed")</script>

     </objectSet>

</unconditionalExclude>

Beispiel 3: Verwenden einer UserAndSystem-Kontextkomponente, um Regeln in beiden Kontexten auszuführen

Wenn das <UnconditionalExclude>-Element für den System- und Benutzerkontext gelten soll, können Sie eine dritte Komponente mit dem UserAndSystem-Kontext erstellen. Regeln in dieser Komponente werden in beiden Kontexten ausgeführt.

<component type="Documents" context="UserandSystem">

   <displayName>MigDocExcludes</displayName>

   <role role="Data">

     <rules>

       <unconditionalExclude>

         <objectSet>

                <script>MigXmlHelper.GenerateDrivePatterns ("*[*.txt]", "Fixed")</script>

         </objectSet>

       </unconditionalExclude>

     </rules>

   </role>

</component>

Beispiele für Exclude-Regeln, die in benutzerdefinierten XML-Migrationsregeln verwendet werden können, finden Sie unter Ausschließen von Dateien und Einstellungen.

Verwendungsbeispiele für Include-Regeln

Das App-Datenverzeichnis ist der Speicherort, für den am häufigsten eine Include-Regel hinzugefügt werden muss. Die GenerateDocPatterns-Funktion schließt diesen Speicherort standardmäßig aus. Falls in Ihrem Unternehmen eine App verwendet wird, die wichtige Daten an diesem Speicherort speichert, können Sie Include-Regeln erstellen, um die Daten zu migrieren. Der Standardspeicherort für PST-Dateien ist z. B. %CSIDL_LOCAL_APPDATA%\Microsoft\Outlook. Die Datei „Migapp.xml“ enthält Migrationsregeln, mit denen nur die mit Microsoft Outlook verknüpften PST-Dateien verschoben werden. Um PST-Dateien einzuschließen, die nicht verknüpft sind, können Sie wie folgt vorgehen:

Beispiel 1: Einschließen einer Dateinamenerweiterung in einem bekannten Benutzerordner

Diese Regel schließt PST-Dateien ein, die sich am Standardspeicherort befinden, aber nicht mit Microsoft Outlook verknüpft sind. Verwenden Sie den Benutzerkontext, um diese Regel für jeden Benutzer auf dem PC auszuführen.

<include filter='MigXmlHelper.IgnoreIrrelevantLinks()'>

     <objectSet>

        <pattern type="File">%CSIDL_LOCAL_APPDATA%\Microsoft\Outlook\*[*.pst]</pattern>

     </objectSet>

</include>

Beispiel 2: Einschließen einer Dateinamenerweiterung in „Programme“

Für Speicherorte außerhalb des Benutzerprofils wie den Ordner „Programme“ können Sie die Regel der Systemkontextkomponente hinzufügen.

<include filter='MigXmlHelper.IgnoreIrrelevantLinks()'>

     <objectSet>

        <pattern type="File">%CSIDL_PROGRAM_FILES%\*[*.pst]</pattern>

     </objectSet>

</include>

Beispiele für Include-Regeln, die in benutzerdefinierten XML-Migrationsregeln verwendet werden können, finden Sie unter Einschließen von Dateien und Einstellungen.

Nächste Schritte

Sie können in der Datei „MigDocs.xml“ oder in anderen XML-Migrationsdateien zusätzliche Regeln für die Migration hinzufügen. Sie können z. B. das <locationModify>-Element verwenden, um Dateien beim Anwenden auf dem Ziel-PC von dem Ordner, in dem sie gesammelt wurden, in einen anderen Ordner zu verschieben. Weitere Informationen finden Sie unter USMT-XML-Referenz.

Sie können eine XML-Schemadatei („MigXML.xsd“) verwenden, um die Syntax Ihrer angepassten XML-Dateien zu überprüfen. Weitere Informationen finden Sie unter USMT-Ressourcen.

Siehe auch

Weitere Ressourcen

Ausschließen von Dateien und Einstellungen
Einschließen von Dateien und Einstellungen