Ausschließen von Dateien und Einstellungen

  • Artikel

Wenn Sie die XML-Migrationsdateien „MigApp.xml“, „MigDoc.xml“ und „MigUser.xml“ angeben, migriert User State Migration Tool (USMT) 5.0 die in Was wird von USMT migriert? beschriebenen Einstellungen und Komponenten. Sie können eine benutzerdefinierte XML-Datei erstellen, um bestimmte Dateien und Einstellungen in die Migration einzuschließen oder von ihr auszuschließen. Außerdem können Sie eine Datei „Config.xml“ erstellen, um eine ganze Komponente von einer Migration auszuschließen. Es ist allerdings nicht möglich, Benutzer mit den XML-Migrationsdateien oder der Datei „Config.xml“ auszuschließen. Die einzige Möglichkeit zum Angeben der ein- und auszuschließenden Benutzer sind die Benutzer-Befehlszeilenoptionen von ScanState. Weitere Informationen finden Sie unter ScanState-Syntax.

Inhalt dieses Themas:

  • Erstellen einer benutzerdefinierten XML-Datei. Sie können die folgenden Elemente verwenden, um auszuschließende Dateien und Einstellungen anzugeben:

    • <include> und <exclude>: Mit den <include>- und <exclude>-Elementen können Sie Objekte anhand von Bedingungen ausschließen. Sie können z. B. mit Ausnahme von MP3-Dateien alle Dateien auf dem Laufwerk „C:\“ migrieren. Bedenken Sie, dass bei diesen Elementen Konflikte und Rangfolge berücksichtigt werden müssen.

    • <unconditionalExclude>: Mit dem <unconditionalExclude>-Element können Sie Daten global ausschließen. Dieses Element hat Vorrang vor allen anderen Include- und Exclude-Regeln in den XML-Dateien. Daher schließt es Objekte unabhängig von allen anderen <include>-Regeln in den XML-Dateien aus. Sie können z. B. alle MP3-Dateien auf dem PC oder alle Dateien in „C:\UserData“ ausschließen.

  • Erstellen einer Datei „Config.xml“: Sie können eine Datei „Config.xml“ erstellen und ändern, um eine ganze Komponente von der Migration auszuschließen. Mit dieser Datei können Sie z. B. die Einstellungen für eine der Standard-Apps ausschließen. Außerdem ist das Erstellen und Ändern einer Datei „Config.xml“ die einzige Möglichkeit, um die Betriebssystemeinstellungen auszuschließen, die zu PCs unter Windows migriert werden. Das Ausschließen von Komponenten mithilfe dieser Datei ist leichter als das Ändern der XML-Migrationsdateien, da Sie keine Kenntnisse in den Migrationsregeln und der Syntax benötigen.

Erstellen einer benutzerdefinierten XML-Datei

Wir empfehlen, eine benutzerdefinierte XML-Datei zu erstellen, anstatt die standardmäßigen XML-Migrationsdateien zu ändern. Wenn Sie eine benutzerdefinierte XML-Datei verwenden, können Sie Ihre Änderungen von den XML-Standarddateien getrennt halten und Änderungen leichter nachverfolgen.

<include> und <exclude>

Die XML-Migrationsdateien „MigApp.xml“, „MigDocs.xml“ und „MigUser.xml“ enthalten das <component>-Element, das in der Regel eine eigenständige Komponente oder eine App wie Microsoft(R) Office Outlook(R) und Word darstellt. Um die mit diesen Komponenten zusammenhängenden Dateien und Registrierungseinstellungen auszuschließen, verwenden Sie die <include>- und <exclude>-Elemente. Sie können diese Elemente z. B. verwenden, um mit Ausnahme von Dateien und Einstellungen mit dem Muster Y alle Dateien und Einstellungen mit dem Muster X zu migrieren, wobei Y spezifischer ist als X. Informationen zur Syntax dieser Elemente finden Sie unter USMT-XML-Referenz.

Hinweis

Wenn Sie eine <exclude>-Regel angeben, müssen Sie immer auch eine entsprechende <include>-Regel festlegen. Falls Sie keine <include>-Regel angeben, werden die spezifischen Dateien oder Einstellungen nicht in die Migration eingeschlossen. Sie sind in diesem Fall bereits von der Migration ausgeschlossen. Eine <exclude>-Regel ohne zugehörige <include>-Regel ist daher unnütz.

  • Beispiel 1: Migrieren aller Dateien in „C:\“ mit Ausnahme von MP3-Dateien

  • Beispiel 2: Migrieren aller Dateien in „C:\Data“ mit Ausnahme von Dateien in „C:\Data\tmp“

  • Beispiel 3: Ausschließen der Dateien in einem Ordner und Einschließen aller Unterordner

  • Beispiel 4: Ausschließen einer Datei aus einem bestimmten Ordner

  • Beispiel 5: Ausschließen einer Datei von einem beliebigen Speicherort

Beispiel 1: Migrieren aller Dateien in „C:\“ mit Ausnahme von MP3-Dateien

Die folgende XML-Datei migriert mit Ausnahme von MP3-Dateien alle Dateien auf dem Laufwerk „C:\“.

<migration urlid="https://www.microsoft.com/migration/1.0/migxmlext/mp3files">
    <!-- This component migrates all files except those with .mp3 extension-->
    <component type="Documents" context="UserAndSystem">
        <displayName _locID="miguser.sharedvideo">MP3 Files</displayName>
        <role role="Data">
            <rules>
                <include filter='MigXmlHelper.IgnoreIrrelevantLinks()'>
                    <objectSet>
                        <pattern type="File">C:\* [*]</pattern>
                    </objectSet>
                </include>
                <exclude>
                    <objectSet>
                        <pattern type="File">C:\* [*.mp3]</pattern>
                    </objectSet>
                </exclude>
            </rules>
        </role>
    </component>
</migration>

Beispiel 2: Migrieren aller Dateien in „C:\Data“ mit Ausnahme von Dateien in „C:\Data\tmp“

Die folgende XML-Datei migriert mit Ausnahme der Dateien und Unterordner in „C:\Data\tmp“ alle Dateien und Unterordner in „C:\Data“.

<migration urlid="https://www.microsoft.com/migration/1.0/migxmlext/test">
    <component type="Documents" context="System">
        <displayName _locID="miguser.sharedvideo">Test component</displayName>
        <role role="Data">
            <rules>
         <include>
            <objectSet>
                 <pattern type="File">C:\Data\* [*]</pattern>
            </objectSet>
          </include>
         <exclude>
             <objectSet>
                   <pattern type="File"> C:\Data\temp\* [*]</pattern>
             </objectSet>
         </exclude>  
            </rules>
        </role>
    </component>
</migration>

Beispiel 3: Ausschließen der Dateien in einem Ordner und Einschließen aller Unterordner

Die folgende XML-Datei migriert alle Unterordner in „C:\EngineeringDrafts“, schließt aber alle Dateien in „C:\EngineeringDrafts“ aus.

<migration urlid="https://www.microsoft.com/migration/1.0/migxmlext/test">
<component type="Documents" context="System">
  <displayName>Component to migrate all Engineering Drafts Documents without subfolders</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>
</migration>

Beispiel 4: Ausschließen einer Datei aus einem bestimmten Ordner

Die folgende XML-Datei migriert mit Ausnahme der Datei „Sample.doc“ in „C:\EngineeringDrafts“ alle Dateien und Unterordner in „C:\EngineeringDrafts“.

<migration urlid="https://www.microsoft.com/migration/1.0/migxmlext/test">
<component type="Documents" context="System">
  <displayName>Component to migrate all Engineering Drafts Documents except Sample.doc</displayName>
  <role role="Data">
    <rules>
         <include>
            <objectSet>
                 <pattern type="File"> C:\EngineeringDrafts\* [*]</pattern>
            </objectSet>
          </include>
      <exclude>
        <objectSet>
          <pattern type="File"> C:\EngineeringDrafts\ [Sample.doc]</pattern>
        </objectSet>
      </exclude>
    </rules>
  </role>
</component>
</migration>

Beispiel 5: Ausschließen einer Datei von einem beliebigen Speicherort

Um eine Datei „Sample.doc“ von einem beliebigen Speicherort auf dem Laufwerk „C:“ auszuschließen, verwenden Sie das <pattern>-Element. Falls mehrere Dateien mit demselben Namen auf dem Laufwerk „C:“ vorhanden sind, werden sie alle ausgeschlossen.

<pattern type="File"> C:\* [Sample.doc] </pattern>

Um eine Datei „Sample.doc“ von einem beliebigen Laufwerk auf dem PC auszuschließen, verwenden Sie das <script>-Element. Falls mehrere Dateien mit demselben Namen vorhanden sind, werden sie alle ausgeschlossen.

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

<unconditionalExclude>

Falls Sie einen Dateityp unabhängig von den anderen <include>- oder <exclude>-Regeln von der Migration ausschließen möchten, können Sie das <unconditionalExclude>-Element verwenden. Dieses Element schließt Objekte global für alle Komponenten aus. Mit diesem Element können Sie z. B. alle MP3-Dateien auf dem PC ausschließen. Wenn Sie „C:\UserData“ mit einer anderen Methode sichern, können Sie den gesamten Ordner von der Migration ausschließen. Dieses Element ist mit Vorsicht zu verwenden. Falls eine Datei, die Sie ausschließen, für eine App benötigt wird, funktioniert die App auf dem Ziel-PC möglicherweise nicht richtig. Informationen zur Syntax dieses Elements finden Sie unter USMT-XML-Referenz.

  • Beispiel 1: Ausschließen aller MP3-Dateien

  • Beispiel 2: Ausschließen aller Dateien auf einem bestimmten Laufwerk

  • Beispiel 3: Ausschließen von Registrierungsschlüsseln

  • Beispiel 4: Ausschließen von „C:\Windows“ und „C:\Program Files“

Beispiel 1: Ausschließen aller MP3-Dateien

Die folgende XML-Datei schließt alle MP3-Dateien von der Migration aus.

<migration urlid="https://www.microsoft.com/migration/1.0/migxmlext/excludefiles">
  <component context="System" type="Documents">
        <displayName>Test</displayName>
        <role role="Data">
            <rules>
             <unconditionalExclude>
                        <objectSet>
    <script>MigXmlHelper.GenerateDrivePatterns ("* [*.mp3]", "Fixed")</script>
                        </objectSet> 
             </unconditionalExclude>
            </rules>
        </role>
    </component>
</migration>

Beispiel 2: Ausschließen aller Dateien auf einem bestimmten Laufwerk

Die folgende XML-Datei schließt nur die Dateien auf dem Laufwerk „C:“ aus.

<migration urlid="https://www.microsoft.com/migration/1.0/migxmlext/allfiles">
    <component type="Documents" context="System">
        <displayName>Test</displayName>
        <role role="Data">
            <rules>
  <unconditionalExclude>
                    <objectSet>
      <pattern type="File">c:\*[*]</pattern>
                    </objectSet>
  </unconditionalExclude>
            </rules>
        </role>
    </component>
</migration>

Beispiel 3: Ausschließen von Registrierungsschlüsseln

Die folgende XML-Datei schließt den Registrierungsschlüssel „HKey_Current_User“ und all seine Unterschlüssel ohne Einschränkungen aus.

<?xml version="1.0" encoding="UTF-8"?>
<migration urlid="https://www.microsoft.com/migration/1.0/migxmlext/miguser">
   <component type="Documents" context="User">
      <displayName>Test</displayName>
      <role role="Data">
         <rules>
            <include>
               <objectSet>
                  <pattern type="Registry">HKCU\testReg[*]</pattern>
               </objectSet>
            </include>
            <unconditionalExclude>
               <objectSet>
                  <pattern type="Registry">HKCU\*[*]</pattern>
               </objectSet>
            </unconditionalExclude>
         </rules>
      </role>
   </component>
</migration>

Beispiel 4: Ausschließen von „C:\Windows“ und „C:\Program Files“

Die folgende XML-Datei schließt die Systemordner von „C:\Windows“ und „C:\Program Files“ ohne Einschränkungen aus. Beachten Sie, dass alle DOCX-, XLS- und PPT-Dateien nicht migriert werden, weil das <unconditionalExclude>-Element Vorrang vor dem <include>-Element hat.

<?xml version="1.0" encoding="UTF-8"?>
<migration urlid="https://www.microsoft.com/migration/1.0/migxmlext/miguser">
   <component type="Documents" context="System">
      <displayName>Test</displayName>
      <role role="Data">
         <rules>
            <include>
               <objectSet>
    <script>MigXmlHelper.GenerateDrivePatterns ("* [*.doc]", "Fixed")</script>
    <script>MigXmlHelper.GenerateDrivePatterns ("* [*.xls]", "Fixed")</script>
    <script>MigXmlHelper.GenerateDrivePatterns ("* [*.ppt]", "Fixed")</script>
               </objectSet>
            </include>
            <unconditionalExclude>
               <objectSet>
                  <pattern type="File">C:\Program Files\* [*]</pattern>
<pattern type="File">C:\Windows\* [*]</pattern>
               </objectSet>
            </unconditionalExclude>
         </rules>
      </role>
   </component>
</migration>

Erstellen einer Datei „Config.xml“

Sie können eine Datei „Config.xml“ erstellen und ändern, wenn Sie Komponenten von der Migration ausschließen möchten. Das Ausschließen von Komponenten mithilfe dieser Datei ist leichter als das Ändern der XML-Migrationsdateien, da Sie keine Kenntnisse in den Migrationsregeln und der Syntax benötigen. Die Datei „Config.xml“ ist eine optionale Datei, die Sie mit der Option /genconfig mit dem Tool ScanState erstellen. Mit der Datei „Config.xml“ können Sie z. B. die Einstellungen für eine der Standard-Apps ausschließen. Außerdem ist das Erstellen und Ändern dieser Datei die einzige Möglichkeit, um die Betriebssystemeinstellungen auszuschließen, die zu PCs unter Windows migriert werden.

  • Um die Einstellungen für eine Standard-App auszuschließen: Geben Sie für die App migrate="no" im <Applications>-Abschnitt der Datei „Config.xml“ an.

  • Um eine Betriebssystemeinstellung auszuschließen: Geben Sie für die Einstellung migrate="no" im <WindowsComponents>-Abschnitt an.

  • Um „Eigene Dateien“ auszuschließen: Geben Sie für „Eigene Dateien“ migrate="no" im <Documents>-Abschnitt an. Alle <include>-Regeln in den XML-Dateien gelten trotzdem. Falls Sie z. B. eine Regel haben, die alle DOCX-Dateien in „Eigene Dateien“ einschließt, werden nur die DOCX-Dateien migriert, die übrigen Dateien aber nicht.

Weitere Informationen finden Sie unter Datei „Config.xml“.

Hinweis

Um eine Komponente aus der Datei „Config.xml“ auszuschließen, setzen Sie den Wert migrate auf "no". Wenn Sie das XML-Kennzeichen für die Komponente aus der Datei „Config.xml“ löschen, wird die Komponente dadurch nicht von der Migration ausgeschlossen.

Siehe auch

Weitere Ressourcen

Anpassen von USMT-XML-Dateien
USMT-XML-Referenz
Datei „Config.xml“