Grundlegendes zu XML-Migrationsdateien

Das Verhalten einer grundlegenden MIGRATION des Benutzerzustandstools (User State Migration Tool, USMT) kann mithilfe von XML-Dateien geändert werden. Diese Dateien enthalten Anweisungen dazu, wo und wie die USMT-Tools Dateien und Einstellungen sammeln und anwenden sollten. USMT enthält drei XML-Dateien, die zum Anpassen einer grundlegenden Migration verwendet werden können: die MigDocs.xml Dateien und MigUser.xml , die ändern, wie Dateien auf dem Quellcomputer ermittelt werden, und die MigApps.xml-Datei, die erforderlich ist, um unterstützte Anwendungseinstellungen zu migrieren. Benutzerdefinierte XML-Dateien und eine Config.xml Datei können erstellt und bearbeitet werden, um die Migration weiter anzupassen.

Dieser Artikel bietet eine Übersicht über die standardmäßigen und benutzerdefinierten XML-Migrationsdateien und enthält Richtlinien zum Erstellen und Bearbeiten einer benutzerdefinierten Version der MigDocs.xml Datei. Die MigDocs.xml Datei verwendet die neue GenerateDocPatterns Funktion, die in USMT verfügbar ist, um Benutzerdokumente automatisch auf einem Quellcomputer zu finden.

Übersicht über die Config.xml-Datei

Die Config.xml Datei ist die Konfigurationsdatei, die mit der /genconfig Option des ScanState-Tools erstellt wird. Es kann verwendet werden, um zu ändern, welche Betriebssystemkomponenten VON USMT migriert werden. Die Config.xml Datei kann mit anderen XML-Dateien verwendet werden, z. B. im folgenden Beispiel:

ScanState.exe /i:migapps.xml /i:MigDocs.xml /genconfig:c:\myFolder\Config.xml

Wenn sie auf diese Weise verwendet wird, steuert die Config.xml Datei aspekte der Migration eng, einschließlich Benutzerprofile, Daten und Einstellungen, ohne andere XML-Dateien zu ändern oder zu erstellen. Weitere Informationen zur Datei finden Sie unter Anpassen von Config.xmlUSMT-XML-Dateien und Config.xml-Datei.

Übersicht über die MigApp.xml-Datei

Die MigApp.xml mit USMT installierte Datei enthält Anweisungen zum Migrieren der Einstellungen für die Anwendungen, die unter Was wird von USMT migriert?. Um Anwendungseinstellungen zu migrieren, muss die MigApp.xml Datei bei Verwendung der ScanState - und LoadState-Tools mit der /i Option eingeschlossen werden. Die MigDocs.xml Dateien und MigUser.xml migrieren keine Anwendungseinstellungen. Eine benutzerdefinierte XML-Datei kann erstellt werden, um zusätzliche Anwendungen einzuschließen. Weitere Informationen finden Sie unter Anpassen von USMT-XML-Dateien.

Übersicht über die MigDocs.xml-Datei

Die MigDocs.xml Datei verwendet die neue GenerateDocPatterns Hilfsfunktion, um Anweisungen für USMT zum Migrieren von Dateien vom Quellcomputer basierend auf dem Speicherort der Dateien zu erstellen. Die MigDocs.xml Datei kann mit den ScanState - und LoadState-Tools verwendet werden, um eine gezieltere Migration durchzuführen als die Verwendung von USMT ohne XML-Anweisungen.

Die Standarddatei MigDocs.xml migriert die folgenden Daten:

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

• Alle Ordner im Stammverzeichnis aller Festplattenlaufwerke. Beispiel: c:\data_mail\*[*].

• Alle Dateien aus dem Stammverzeichnis des Ordners Profile, mit Ausnahme von Dateien im Systemprofil. Beispiel: c:\users\name[mail.pst].

• Alle Ordner aus dem Stammverzeichnis des Ordners Profile, mit Ausnahme der Systemprofilordner. Beispiel: c:\users\name\new folder\*[*].

• Freigegebene Standardordner:

  • CSIDL_COMMON_DESKTOPDIRECTORY

  • CSIDL_COMMON_FAVORITES

  • CSIDL_COMMON_DOCUMENTS

  • CSIDL_COMMON_MUSIC

  • CSIDL_COMMON_PICTURES

  • CSIDL_COMMON_VIDEO

  • FOLDERID_PublicDownloads

• Standardbenutzerprofilordner 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 Standarddatei MigDocs.xml migriert die folgenden Daten nicht:

• Dateien, die sowohl mit den ausgeblendeten attributen als auch mit systemattributen gekennzeichnet sind.

• Dateien und Ordner auf Wechseldatenträgern.

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

• Ordner, die installierte Anwendungen enthalten.

Die /genmigxml Option kann mit dem ScanState-Tool verwendet werden, um zu überprüfen und zu ändern, welche Dateien migriert werden.

Übersicht über die MigUser.xml-Datei

Die MigUser.xml Datei enthält Anweisungen für USMT zum Migrieren von Benutzerdateien basierend auf Dateinamenerweiterungen. Die MigUser.xml Datei kann mit den ScanState - und LoadState-Tools verwendet werden, um eine gezieltere Migration durchzuführen als die Verwendung von USMT ohne XML-Anweisungen. Die MigUser.xml Datei sammelt alle Dateien aus den Standardbenutzerprofilordnern und alle Dateien auf dem Computer mit den angegebenen Dateinamenerweiterungen.

Die Standarddatei MigUser.xml migriert die folgenden Daten:

• Alle Dateien aus den Standardbenutzerprofilordnern, die wie folgt beschrieben werden:

  • CSIDL_MYVIDEO

  • CSIDL_MYMUSIC

  • CSIDL_DESKTOP

  • CSIDL_STARTMENU

  • CSIDL_PERSONAL

  • CSIDL_MYPICTURES

  • CSIDL_FAVORITES

  • CSIDL_QUICK LAUNCH

• Dateien mit den folgenden Erweiterungen:

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

  Hinweis

  Das Sternchen (*) steht für null oder mehr Zeichen.

  Hinweis

  Die OpenDocument-Erweiterungen (*.odt, *.odp, *.ods), die Von Microsoft Office-Anwendungen verwendet werden können, werden standardmäßig nicht migriert.

Die Standarddatei MigUser.xml migriert die folgenden Daten nicht:

• Dateien, die sowohl mit den Attributen Hidden als auch System gekennzeichnet sind.

• Dateien und Ordner auf Wechseldatenträgern.

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

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

Die MigUser.xml Datei kann kopiert und dann geändert werden, um Standardordner für Benutzerprofile und Dateinamenerweiterungen einzuschließen oder auszuschließen. Wenn alle Erweiterungen für die Dateien bekannt sind, die vom Quellcomputer migriert werden müssen, verwenden Sie die MigUser.xml Datei, um alle relevanten Daten zu verschieben, unabhängig vom Speicherort der Dateien. Das Hinzufügen aller Dateierweiterungen, die zur MigUser.xml Datei migriert werden müssen, kann jedoch zu einer Migration führen, die mehr Dateien als beabsichtigt enthält. Wenn beispielsweise alle .jpg Dateien migriert werden, können auch Bilddateien wie Miniaturansichten und Logos aus Legacyanwendungen migriert werden, die auf dem Quellcomputer installiert sind.

Verwenden mehrerer XML-Dateien

Mit den Tools ScanState und LoadState können mehrere XML-Dateien verwendet werden. Jede der XML-Standarddateien, die in USMT enthalten sind oder von USMT generiert werden, wird für eine bestimmte Komponente der Migration konfiguriert. Benutzerdefinierte XML-Dateien können auch verwendet werden, um diese Standarddateien durch weitere Migrationsregeln zu ergänzen.

Beispielsweise können alle XML-Migrationsdateitypen für eine einzelne Migration verwendet werden, wie im folgenden Beispiel gezeigt:

ScanState.exe <store> /config:c:\myFolder\Config.xml /i:migapps.xml /i:MigDocs.xml /i:CustomRules.xml

XML-Regeln für die Migration von Benutzerdateien

Wenn das Dataset unbekannt ist oder viele Dateien außerhalb der Standardmäßigen Benutzerprofilordner gespeichert werden, ist die MigDocs.xml bessere Wahl als die MigUser.xml Datei, da die MigDocs.xml Datei einen breiteren Datenbereich sammelt. Die MigDocs.xml Datei migriert Datenordner basierend auf dem Speicherort. Die MigUser.xml Datei migriert nur die Dateien mit den angegebenen Dateinamenerweiterungen.

Erstellen Sie benutzerdefinierte XML-Dateien, um mehr Kontrolle über die Migration zu haben. Weitere Informationen zum Erstellen benutzerdefinierter XML-Dateien finden Sie unter Erstellen und Bearbeiten einer benutzerdefinierten XML-Datei.

Erstellen und Bearbeiten einer benutzerdefinierten XML-Datei

Die /genmigxml Befehlszeilenoption kann verwendet werden, um zu bestimmen, welche Dateien in der Migration enthalten sind. Die /genmigxml Option erstellt eine Datei an einem angegebenen Speicherort. Die XML-Regeln in der Datei können dann überprüft und bei Bedarf Änderungen vorgenommen werden.

So generieren Sie die XML-Migrationsregeldatei für einen Quellcomputer:

1. Wählen SieAlle Programme>starten>Zubehör aus.

2. Klicken Sie mit der rechten Maustaste auf Eingabeaufforderung, und wählen Sie dann Ausführen als aus.

3. Wählen Sie ein Konto mit Administratorrechten aus, geben Sie ein Kennwort an, und wählen Sie dann OK aus.

4. Geben Sie an der Eingabeaufforderung Folgendes ein:

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

   Dabei gilt Folgendes:

   • <USMTpath> : Speicherort auf dem Quellcomputer der gespeicherten USMT-Dateien und -Tools.
   • < >filepath.xml : vollständiger Pfad zu einer Datei, in der der Bericht gespeichert werden kann.

   Geben Sie beispielsweise Folgendes ein:

   cd /d c:\USMT
   ScanState.exe /genmigxml:"C:\Users\USMT Tester\Desktop\genMig.xml"
   

Die GenerateDocPatterns-Funktion

Die MigDocs.xml Datei ruft die GenerateDocPatterns -Funktion auf, die drei boolesche Werte akzeptiert. Die Einstellungen können geändert werden, um die Art und Weise zu ändern, wie die MigDocs.xml Datei die XML-Regeln für die Migration generiert.

• ScanProgramFiles: Dieses Argument ist nur gültig, wenn die GenerateDocPatterns Funktion in einem Systemkontext aufgerufen wird. Dieses Argument bestimmt, ob das Verzeichnis "Programme" überprüft werden soll, um registrierte Dateinamenerweiterungen für bekannte Anwendungen zu erfassen.

  Standardwert: False

  Wenn sie beispielsweise auf TRUE festgelegt ist, ermittelt und migriert die Funktion .doc Dateien im Microsoft Office-Verzeichnis, da .doc eine Dateinamenerweiterung ist, die für eine Microsoft Office-Anwendung registriert ist. Die GenerateDocPatterns Funktion generiert dieses Einschlussmuster für .doc Dateien:

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

  Wenn ein untergeordneter Ordner eines eingeschlossenen Ordners eine installierte Anwendung enthält, ScanProgramFiles wird auch eine Ausschlussregel für den untergeordneten Ordner erstellt. Alle Ordner unter dem Anwendungsordner werden rekursiv auf registrierte Dateinamenerweiterungen überprüft.

• IncludePatterns: Dieses Argument bestimmt, ob Ausschluss- oder Includemuster im XML-Code generiert werden sollen. Wenn dieses Argument auf TRUE festgelegt ist, generiert die GenerateDocPatterns Funktion Includemuster, und die Funktion muss unter dem <include> -Element hinzugefügt werden. Wenn Sie dieses Argument in FALSE ändern, werden Ausschlussmuster generiert, und die Funktion muss unter dem <exclude> -Element hinzugefügt werden.

  Standardwert: True

• SystemDrive: Dieses Argument bestimmt, ob Muster für alle Festplattenlaufwerke oder nur für das Systemlaufwerk generiert werden sollen. Wenn Sie dieses Argument in TRUE ändern, werden alle Muster auf das Systemlaufwerk beschränkt.

  Standardwert: False

Verwendung:

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

So erstellen Sie Includedatenmuster nur für das Systemlaufwerk:

<include filter='MigXmlHelper.IgnoreIrrelevantLinks()'>
     <objectSet>
        <script>MigXmlHelper.GenerateDocPatterns ("FALSE","TRUE","TRUE")</script>
     </objectSet>
</include>

So erstellen Sie eine Includeregel zum Sammeln von Dateien für registrierte Erweiterungen aus dem Verzeichnis %PROGRAMFILES%:

<include filter='MigXmlHelper.IgnoreIrrelevantLinks()'>
     <objectSet>
        <script>MigXmlHelper.GenerateDocPatterns ("TRUE","TRUE","FALSE")</script>
     </objectSet>
</include>

So erstellen Sie Ausschlussdatenmuster:

<exclude filter='MigXmlHelper.IgnoreIrrelevantLinks()'>
     <objectSet>
        <script>MigXmlHelper.GenerateDocPatterns ("FALSE","FALSE","FALSE")</script>
     </objectSet>
</exclude>

Grundlegendes zum System- und Benutzerkontext

Die XML-Migrationsdateien enthalten zwei <Komponentenelemente> mit unterschiedlichen Kontexteinstellungen :

• Der Systemkontext gilt für Dateien auf dem Computer, die nicht im Verzeichnis Benutzerprofile gespeichert sind.
• Der Benutzerkontext gilt für Dateien, die speziell für einen einzelnen Benutzer sind.

Systemkontext

Der Systemkontext enthält Regeln für Daten außerhalb des Verzeichnisses "Benutzerprofile". Wenn die Funktion beispielsweise in einem Systemkontext in der MigDocs.xml Datei aufgerufen wird, erstellt sie GenerateDocPatterns Muster für alle allgemeinen Shellordner, Dateien im Stammverzeichnis der Festplatten und Ordner im Stammverzeichnis der Festplatten. Die folgenden Ordner sind enthalten:

• CSIDL_COMMON_DESKTOPDIRECTORY

• CSIDL_COMMON_FAVORITES

• CSIDL_COMMON_DOCUMENTS

• CSIDL_COMMON_MUSIC

• CSIDL_COMMON_PICTURES

• CSIDL_COMMON_VIDEO

• FOLDERID_PublicDownloads

Benutzerkontext

Der Benutzerkontext enthält Regeln für Daten im Verzeichnis Benutzerprofile. Wenn die Funktion in einem Benutzerkontext in der MigDocs.xml Datei aufgerufen wird, erstellt sie GenerateDocPatterns Muster für alle Benutzershellordner, Dateien im Stammverzeichnis des Profils und Ordner im Stammverzeichnis des Profils. Die folgenden Ordner sind enthalten:

• 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 benutzerdefinierte Versionen von XML-Dateien

Beispiele für die Verwendung von Ausschlussregeln

In den folgenden Beispielen verfügt der Quellcomputer über eine .txt Datei namens new text document in einem Verzeichnis namens new folder. Das Standardverhalten MigDocs.xml migriert die neue Textdatei document.txt und alle dateien, die new folder im Verzeichnis enthalten sind. Die von der Funktion generierten Regeln sind:

Um die neue Textdatei document.txt und alle.txt Dateien in new folderauszuschließen, können die folgenden Änderungen vorgenommen werden:

Beispiel 1: Ausschließen aller .txt Dateien in einem Ordner

Um Regel 1 auszuschließen, muss eine genaue Übereinstimmung mit dem Dateinamen vorliegen. Für Regel 2 kann jedoch ein Muster erstellt werden, um Dateien mithilfe 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 Includeregeln zu geben

Wenn der Dateiname oder speicherort der Datei nicht bekannt ist, aber die Dateinamenerweiterung bekannt ist, kann die GenerateDrivePatterns Funktion verwendet werden. Die Regel ist jedoch weniger spezifisch als die von der MigDocs.xml Datei generierte Standardeinschließregel, sodass sie keinen Vorrang hat. Das <UnconditionalExclude-Element> muss verwendet werden, um dieser Regel Vorrang vor der standardmäßigen Includeregel 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 zum Ausführen von Regeln in beiden Kontexten

Um das <UnconditionalExclude-Element> sowohl auf den System- als auch auf den Benutzerkontext anzuwenden, kann eine dritte Komponente mithilfe des UserandSystem-Kontexts erstellt werden. 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>

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

Beispiele für die Verwendung von Regeln einschließen

Das Anwendungsdatenverzeichnis ist der am häufigsten verwendete Speicherort, für den eine Includeregel hinzugefügt werden muss. Die GenerateDocPatterns Funktion schließt diesen Speicherort standardmäßig aus. Wenn die Organisation eine Anwendung verwendet, die wichtige Daten an diesem Speicherort speichert, können Einschließregeln erstellt werden, um die Daten zu migrieren. Der Standardspeicherort für PST-Dateien lautet z. B.: %CSIDL_LOCAL_APPDATA%\Microsoft\Outlook. Die MigApp.xml Datei enthält Migrationsregeln, um nur die PST-Dateien zu verschieben, die mit Microsoft Outlook verknüpft sind. Um PST-Dateien einzuschließen, die nicht verknüpft sind, kann die folgende Änderung vorgenommen werden:

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

Diese Regel umfasst PST-Dateien , 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 Computer 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, z. B. im Ordner "Programme", kann die Regel der Systemkontextkomponente hinzugefügt werden.

<include filter='MigXmlHelper.IgnoreIrrelevantLinks()'>
     <objectSet>
        <pattern type="File">%CSIDL_PROGRAM_FILES%\*[*.pst]</pattern>
     </objectSet>
</include>

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

Nächste Schritte

Zusätzliche Regeln für die Migration können in der MigDocs.xml Datei oder in anderen XML-Migrationsdateien enthalten sein. Beispielsweise kann das <locationModify> -Element verwendet werden, um Dateien aus dem Ordner, in dem sie gesammelt wurden, in einen anderen Ordner zu verschieben, wenn sie auf den Zielcomputer angewendet werden.

Eine XML-Schemadatei (MigXML.xsd) kann verwendet werden, um die Syntax der benutzerdefinierten XML-Dateien zu überprüfen. Weitere Informationen finden Sie unter USMT-Ressourcen.

Verwandte Artikel

• Schließen Sie Dateien und Einstellungen aus.
• Schließen Sie Dateien und Einstellungen ein.