Freigeben über


Ausschließen von Dateien und Einstellungen

Wenn die Migration .xml Dateien MigApp.xml, MigDocs.xmlund MigUser.xml angegeben sind, migriert das User State Migration Tool (USMT) die aufgeführten Einstellungen und Komponenten, wie unter Was wird von USMT migriert? Eine benutzerdefinierte .xml-Datei kann erstellt werden, um weiter anzugeben, was in die Migration eingeschlossen oder ausgeschlossen werden soll. Darüber hinaus kann eine Config.xml Datei erstellt werden, um eine gesamte Komponente von einer Migration auszuschließen. Benutzer können jedoch nicht ausgeschlossen werden, indem die Migration .xml Dateien oder die Config.xml Datei verwendet wird. Die einzige Möglichkeit, anzugeben, welche Benutzer ein- und ausgeschlossen werden sollen, ist die Verwendung der Benutzeroptionen in der Befehlszeile im ScanState-Tool . Weitere Informationen finden Sie im Abschnitt Benutzeroptionen des Artikels ScanState-Syntax .

Zu den Methoden zum Anpassen der Migration sowie zum Ein- und Ausschließen von Dateien und Einstellungen gehören:

  • Erstellen Sie eine benutzerdefinierte .xml-Datei. Die folgenden Elemente können verwendet werden, um anzugeben, was ausgeschlossen werden soll:

    • Include und exclude: Die <Include> - und <Exclude-Elemente> können verwendet werden, um Objekte mit Bedingungen auszuschließen. Beispielsweise können alle Dateien, die sich auf dem C:\ Laufwerk befinden, mit Ausnahme aller .mp3 Dateien migriert werden. Es ist wichtig, daran zu denken, dass Konflikte und Rangfolge für diese Elemente gelten.

    • unconditionalExclude: Das <bedingungsloseExclude-Element> kann verwendet werden, um Daten global auszuschließen. Dieses Element hat Vorrang vor allen anderen Ein- und Ausschlussregeln in den .xml Dateien. Daher schließt dieses Element Objekte unabhängig von anderen <Includeregeln> aus, die sich in den .xml Dateien befinden. Beispielsweise können alle .mp3 Dateien auf dem Computer oder alle Dateien aus C:\UserData ausgeschlossen werden.

  • Erstellen einer Config.xml Datei: Eine Config.xml Datei kann erstellt und geändert werden, um eine gesamte Komponente von der Migration auszuschließen. Diese Datei kann beispielsweise verwendet werden, um die Einstellungen für eine der Standardanwendungen auszuschließen. Darüber hinaus ist das Erstellen und Ändern einer Config.xml Datei die einzige Möglichkeit, die Betriebssystemeinstellungen auszuschließen, die zu Computern unter Windows migriert werden. Das Ausschließen von Komponenten, die diese Datei verwenden, ist einfacher als das Ändern der Migration .xml Dateien, da keine Kenntnisse mit den Migrationsregeln und der Syntax erforderlich sind.

Erstellen einer benutzerdefinierten .xml-Datei

Microsoft empfiehlt, eine benutzerdefinierte .xml-Datei zu erstellen, anstatt die Standardmigration .xml Dateien zu ändern. Wenn eine benutzerdefinierte .xml-Datei verwendet wird, können die Änderungen von der Standarddatei.xml getrennt bleiben, was das Nachverfolgen der Änderungen erleichtert.

<einschließen> und <ausschließen>

Die Migration .xml Dateien, MigApp.xml, MigDocs.xmlund MigUser.xmlenthalten das <Komponentenelement> , das in der Regel eine eigenständige Komponente oder eine Anwendung wie Microsoft Office Outlook und Word darstellt. Um die Dateien und Registrierungseinstellungen auszuschließen, die diesen Komponenten zugeordnet sind, verwenden Sie die <Include-> und <Exclude-Elemente> . Diese Elemente können beispielsweise verwendet werden, um alle Dateien und Einstellungen mit Muster X zu migrieren, mit Ausnahme von Dateien und Einstellungen mit Muster Y, wobei Y spezifischer als X ist. Die Syntax dieser Elemente finden Sie in der USMT-XML-Referenz.

Hinweis

Wenn eine <Ausschlussregel> angegeben ist, geben Sie immer eine entsprechende <Includeregel> an. Andernfalls sind die spezifischen Dateien oder Einstellungen nicht enthalten, wenn <keine Include-Regel> angegeben ist. Sie sind bereits von der Migration ausgeschlossen. Daher ist eine Ausnahmeregel ohne Begleitung<> nicht erforderlich.

Beispiel 1: Migrieren aller Dateien von C:\ außer .mp3 Dateien

Die folgende .xml-Datei migriert alle Dateien, die sich auf Laufwerk C: befinden, mit Ausnahme aller .mp3 Dateien.

<migration urlid="http://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 mit C:\Data Ausnahme von Dateien in C:\Data\tmp

Die folgende .xml Datei migriert alle Dateien und Unterordner in C:\Datamit Ausnahme der Dateien und Unterordner in C:\Data\tmp.

<migration urlid="http://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, aber einschließen aller Unterordner

Die folgende .xml-Datei migriert alle Unterordner in C:\EngineeringDrafts, schließt jedoch alle Dateien aus, die sich in C:\EngineeringDraftsbefinden.

<migration urlid="http://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 alle Dateien und Unterordner in C:\EngineeringDraftsmit Ausnahme der Sample.doc Datei in C:\EngineeringDrafts.

<migration urlid="http://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 Sample.doc Datei von einem beliebigen Speicherort auf Laufwerk C: auszuschließen, verwenden Sie das <Pattern-Element> . Wenn mehrere Dateien mit demselben Namen auf Laufwerk C: vorhanden sind, werden alle diese Dateien ausgeschlossen.

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

Um eine Sample.doc Datei von jedem Laufwerk auf dem Computer auszuschließen, verwenden Sie das <script-Element> . Wenn mehrere Dateien mit demselben Namen vorhanden sind, werden alle diese Dateien ausgeschlossen.

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

Beispiele für die Verwendung von XML zum Ausschließen von Dateien, Ordnern und Registrierungsschlüsseln

Im Folgenden finden Sie einige Beispiele für die Verwendung von XML zum Ausschließen von Dateien, Ordnern und Registrierungsschlüsseln. Weitere Informationen finden Sie in der 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="http://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 aus, die sich auf Laufwerk C: befinden.

<migration urlid="http://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 HKEY_CURRENT_USER Registrierungsschlüssel und alle zugehörigen Unterschlüssel bedingungslos aus.

<?xml version="1.0" encoding="UTF-8"?>
<migration urlid="http://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 C:\Windows von und C:\Program Files

Die folgende .xml Datei schließt die Systemordner von C:\Windows und C:\Program Filesbedingungslos aus. Alle *.docxDateien , *.xls und *.ppt werden nicht migriert, da das <bedingungsloseExclude-Element> Vorrang vor dem <include-Element> hat.

<?xml version="1.0" encoding="UTF-8"?>
<migration urlid="http://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 XML-Konfigurationsdatei

Eine Config.xml Datei kann erstellt und geändert werden, um Komponenten von der Migration auszuschließen. Das Ausschließen von Komponenten, die diese Datei verwenden, ist einfacher als das Ändern der Migration .xml Dateien, da keine Kenntnisse mit den Migrationsregeln und der Syntax erforderlich sind. Config.xml ist eine optionale Datei, die mithilfe der /genconfig Befehlszeilenoption mit dem ScanState-Tool erstellt werden kann. Beispielsweise kann die Config.xml Datei verwendet werden, um die Einstellungen für eine der Standardanwendungen auszuschließen. Darüber hinaus ist das Erstellen und Ändern dieser Datei die einzige Möglichkeit, die Betriebssystemeinstellungen auszuschließen, die zu Computern unter Windows migriert werden.

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

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

  • So schließen Sie den Ordner Dokumente aus: Geben Sie migrate="no" für den Ordner Dokumente im Abschnitt Dokumente> an<. Alle <Includeregeln> in den .xml-Dateien werden weiterhin angewendet. Wenn beispielsweise eine Regel vorhanden ist, die alle .docx Dateien im Ordner Dokumente enthält, werden .docx Dateien weiterhin migriert. Alle zusätzlichen Dateien, die nicht .docx sind, werden jedoch nicht migriert.

Weitere Informationen finden Sie unter Config.xml-Datei.

Hinweis

Um eine Komponente aus der Config.xml Datei auszuschließen, legen Sie den Migrate-Wert auf "nein" fest. Das Löschen des XML-Tags für die Komponente aus der Config.xml Datei schließt die Komponente nicht von der Migration aus.