Share via


Ausschließen von Dateien und Einstellungen

Wenn Sie die XML-Migrationsdateien „MigApp.xml“, „Migdocs“ und „MigUser.xml“ angeben, werden die aufgeführten Einstellungen und Komponenten von USMT (User State Migration Tool) 10.0 wie unter Was wird von USMT migriert? beschrieben migriert. Sie können eine benutzerdefinierte XML-Datei erstellen, um genauer anzugeben, welche Elemente in die Migration aufgenommen und welche Elemente aus der Migration ausgeschlossen werden sollen. 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 Elementen „<include>“ und „<exclude>“ können Sie Objekte mit Bedingungen ausschließen. Sie können z. B. mit Ausnahme von MP3-Dateien alle Dateien auf dem Laufwerk „C:\“ migrieren. Bedenken Sie, dass Konflikte und Rangfolge für diese Elemente gelten.

    • unconditionalExclude: Mit dem <unconditionalExclude>-Element können Daten global ausgeschlossen werden. 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 der Datei „Config.xml“: Sie können die Datei „Config.xml“ erstellen und ändern, um eine gesamte 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. Beispiel: Mit diesen Elemente können Sie alle Dateien und Einstellungen mit dem Muster X, ausgenommen der Dateien und Einstellungen mit Muster Y migrieren. Dabei ist Y spezifischer als X. Die Syntax für diese 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 nicht erforderlich.

 

  • 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>

USMT-XML-Referenz

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 optionale Datei „Config.xml“ kann mit ScanState und der Befehlszeilenoption /genconfig erstellt werden. 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.

  • So schließen Sie die Einstellungen für eine Standardanwendung aus: Geben Sie für die Anwendung in der Datei „Config.xml“ im Abschnitt „<Applications>“ den Code migrate="no" an.

  • So schließen Sie eine Betriebssystemeinstellung aus: Geben Sie für die Einstellung im Abschnitt „<WindowsComponents>“ den Code migrate="no" an.

  • So schließen Sie „Eigene Dateien“ aus: Geben Sie im Abschnitt „<Documents>“ für „Eigene Dateien“ den Code migrate="no" 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, legen Sie den Wert für migrate auf "no" fest. 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.

 

Verwandte Themen

Anpassen von USMT-XML-Dateien

USMT-XML-Referenz

Datei „Config.xml“