Häufige Probleme mit dem Migrationstool für den Benutzerstatus (User State Migration Tool, USMT)

  • Artikel

In den folgenden Abschnitten werden häufige Probleme erläutert, die beim Ausführen der USMT 10.0-Tools auftreten können. USMT erzeugt Protokolldateien, in denen alle Fehler, die während des Migrationsprozesses aufgetreten sind, ausführlicher beschrieben werden. Diese Protokolle können zur Problembehandlung von Migrationsfehlern verwendet werden.

Allgemeine Richtlinien zum Identifizieren von Migrationsproblemen

Wenn während der Migration ein Problem oder eine Fehlermeldung auftritt, können Sie die folgenden allgemeinen Richtlinien verwenden, um die Ursache des Problems zu ermitteln:

  • Untersuchen Sie die Protokolle ScanState, LoadState und UsmtUtils, um die genauen USMT-Fehlermeldungen und® Windows-API-Fehlermeldungen (Application Programming Interface, API) zu erhalten. Weitere Informationen zu USMT-Rückgabecodes und Fehlermeldungen finden Sie unter Rückgabecodes. Sie können weitere Informationen zu allen aufgelisteten Windows-Systemfehlercodes erhalten, indem Sie in ein Eingabeaufforderungsfenster net.exe helpmsg <error_number> eingeben, wobei <error_number> die von der Fehlermeldung generierte Fehlercodenummer ist. Weitere Informationen zu Systemfehlercodes finden Sie unter Systemfehlercodes (0-499).

    In den meisten Fällen geben die Protokolle ScanState und LoadState an, warum eine USMT-Migration fehlschlägt. Es wird empfohlen, dass Sie die /v:5 Option verwenden, wenn Sie Ihre Migration testen. Dieser Ausführlichkeitsgrad kann in einer Produktionsmigration angepasst werden. Die Verringerung der Ausführlichkeitsstufe kann es jedoch schwieriger machen, Fehler zu diagnostizieren, die bei Produktionsmigrationen auftreten. Sie können eine Ausführlichkeitsstufe höher als 5 verwenden, wenn die Protokolldateiausgabe an einen Debugger gelangen soll.

    Hinweis

    Wenn Sie die Tools ScanState und LoadState mit der /v:5 Option ausführen, wird eine ausführliche Protokolldatei erstellt. Obwohl diese Option die Protokolldatei groß macht, können Sie anhand der zusätzlichen Details ermitteln, wo Migrationsfehler aufgetreten sind.

  • Verwenden Sie die /Verify Option mit dem UsmtUtils-Tool, um zu bestimmen, ob Dateien in einem komprimierten Migrationsspeicher beschädigt sind. Weitere Informationen finden Sie unter Überprüfen der Bedingung eines komprimierten Migrationsspeichers.

  • Verwenden Sie die /Extract Option mit dem UsmtUtils-Tool, um Dateien aus einem komprimierten Migrationsspeicher zu extrahieren. Weitere Informationen finden Sie unter Extrahieren von Dateien aus einem komprimierten USMT-Migrationsspeicher.

  • Erstellen Sie mithilfe der /Progress Option zum Überwachen Ihrer Migration ein Fortschrittsprotokoll.

  • Rufen Sie für die Quell- und Zielcomputer Betriebssysteminformationen und Versionen von Anwendungen wie Internet Explorer und alle anderen relevanten Programme ab. Überprüfen Sie dann die genauen Schritte, die zum Reproduzieren des Problems erforderlich sind. Diese Informationen können Ihnen helfen, zu verstehen, was falsch ist, und das Problem in Ihrer Testumgebung zu reproduzieren.

  • Melden Sie sich ab, nachdem Sie das LoadState-Tool ausgeführt haben. Einige Einstellungen wie Schriftarten, Desktophintergründe und Bildschirmschonereinstellungen werden erst wirksam, wenn sich der Endbenutzer das nächste Mal anmeldet.

  • Schließen Sie alle Anwendungen, bevor Sie scanState - oder LoadState-Tools ausführen. Wenn einige Anwendungen während des ScanState - oder LoadState-Prozesses ausgeführt werden, migriert USMT möglicherweise einige Daten nicht. Wenn Beispielsweise Microsoft Outlook® geöffnet ist, migriert USMT möglicherweise keine PST-Dateien.

    Hinweis

    USMT schlägt fehl, wenn eine Datei oder Einstellung nicht migriert werden kann, es sei denn, Sie geben die /c Option an. Wenn Sie die /c Option angeben, ignoriert USMT Fehler. Es protokolliert jedoch einen Fehler, wenn eine Datei angezeigt wird, die verwendet wird, die nicht migriert wurde.

Benutzerkontoprobleme

In den folgenden Abschnitten werden häufige Probleme mit Benutzerkonten beschrieben. Erweitern Sie den Abschnitt, um empfohlene Lösungen anzuzeigen.

Ich habe Probleme beim Erstellen lokaler Konten auf dem Zielcomputer.

Auflösung: Weitere Informationen zum Erstellen von Konten und Migrieren lokaler Konten finden Sie unter Migrieren von Benutzerkonten.

Nicht alle Benutzerkonten wurden auf den Zielcomputer migriert.

Ursachen/Lösungen Es gibt zwei mögliche Ursachen für dieses Problem:

Wenn Sie die ScanState- und LoadState-Tools unter Windows 7, Windows 8 oder Windows 10 ausführen, müssen Sie sie im Administratormodus über ein Konto mit Administratoranmeldeinformationen ausführen, um sicherzustellen, dass alle angegebenen Benutzer migriert werden. So führen Sie im Administratormodus aus:

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

  2. Klicken Sie mit der rechten Maustaste auf Eingabeaufforderung.

  3. Wählen Sie Als Administrator ausführen aus.

  4. Geben Sie den befehlLoadState.exe oder ScanState.exe an.

Wenn Sie USMT nicht im Administratormodus ausführen, wird nur das angemeldete Benutzerprofil in die Migration einbezogen.

Benutzerkonten auf dem Computer, die nicht verwendet wurden, werden nicht migriert. Wenn Sie z. B. User1 zum Computer hinzufügen, aber User1 sich nie anmeldet, migriert USMT das User1-Konto nicht.

Benutzerkonten, die ich ausgeschlossen habe, wurden auf den Zielcomputer migriert.

Ursache: Der von Ihnen angegebene Befehl hatte möglicherweise Konflikt- ui und /ue -Optionen. Wenn ein Benutzer mit der /ui Option und mit der /ue Option oder /uel gleichzeitig angegeben wird, wird der Benutzer in die Migration einbezogen. Wenn Sie beispielsweise angeben /ui:domain1\* /ue:domain1\user1, wird User1 migriert, da die /ui Option Vorrang hat.

Auflösung: Weitere Informationen zur gemeinsamen Verwendung der /ui Optionen und /ue finden Sie in den Beispielen im Artikel ScanState-Syntax .

Ich verwende die Option "/uel", aber viele Konten werden weiterhin in die Migration einbezogen.

Ursache: Die /uel Option hängt vom Datum der letzten Änderung der NTUser.dat-Datei des Benutzers ab. Es gibt Szenarien, in denen dieses Datum der letzten Änderung möglicherweise nicht mit dem Datum der letzten Anmeldung der Benutzer übereinstimmt.

Auflösung: Dies ist eine Einschränkung der /uel Option. Sie müssen diese Benutzer möglicherweise manuell mit der /ue Option ausschließen.

Das LoadState-Tool meldet einen Fehler als Rückgabecode 71 und kann ein Benutzerprofil während eines Migrationstests nicht wiederherstellen.

Ursache: Wenn Sie während eines Migrationstests das ScanState-Tool auf Ihrem Testcomputer ausführen und dann Benutzerprofile löschen, um das LoadState-Tool auf demselben Computer zu testen, ist möglicherweise ein in Konflikt stehenden Schlüssel in der Registrierung vorhanden. Mithilfe des Befehls net use zum Entfernen eines Benutzerprofils werden Ordner und Dateien gelöscht, die diesem Profil zugeordnet sind, der Registrierungsschlüssel wird jedoch nicht entfernt.

Auflösung: Verwenden Sie zum Löschen eines Benutzerprofils das Element Benutzerkonten in Systemsteuerung. So korrigieren Sie eine unvollständige Löschung eines Benutzerprofils:

  1. Öffnen Sie den Registrierungs-Editor, indem Sie regedit.exe an einer Eingabeaufforderung mit erhöhten Rechten eingeben.

  2. Navigieren Sie zu HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\ProfileList.

    Jedes Benutzerprofil wird in einem Systembezeichnerschlüssel unter ProfileListgespeichert.

  3. Löschen Sie den Schlüssel für das Benutzerprofil, das Sie entfernen möchten.

Dateien, die vor der Migration nicht verschlüsselt wurden, werden jetzt mit dem Konto verschlüsselt, das zum Ausführen des LoadState-Tools verwendet wird.

Ursache: Das ScanState-Tool wurde mit der /EFS:copyraw Option zum Migrieren verschlüsselter Dateien und EFS-Zertifikate (Encrypting File System) ausgeführt. Das Verschlüsselungsattribut wurde für einen Ordner festgelegt, der migriert wurde, aber das Attribut wurde vor der Migration aus dem Dateiinhalt dieses Ordners entfernt.

Auflösung: Bevor Sie das ScanState-Tool für eine Migration verwenden, die verschlüsselte Dateien und EFS-Zertifikate enthält, können Sie das Verschlüsselungstool an der Eingabeaufforderung ausführen, um die Verschlüsselungseinstellungen für Dateien und Ordner zu überprüfen und zu ändern. Sie müssen das Verschlüsselungsattribut aus Ordnern entfernen, die unverschlüsselte Dateien enthalten, oder den Inhalt aller Dateien in einem verschlüsselten Ordner verschlüsseln.

Um die Verschlüsselung von Dateien zu entfernen, die bereits falsch migriert wurden, müssen Sie sich beim Computer mit dem Konto anmelden, das Sie zum Ausführen des Tools LoadState verwendet haben, und dann die Verschlüsselung aus den betroffenen Dateien entfernen.

Das LoadState-Tool meldet einen Fehler als Rückgabecode 71 und einen Windows-Fehler 2202 in der Protokolldatei.

Ursache: Der Computername wurde während einer Offlinemigration eines lokalen Benutzerprofils geändert.

Auflösung: Sie können die /mu Option verwenden, wenn Sie das LoadState-Tool ausführen, um einen neuen Namen für den Benutzer anzugeben. Beispiel:

LoadState.exe  /i:MigApp.xml /i:MigDocs.xml \\server\share\migration\mystore 
/progress:Progress.log /l:LoadState.log /mu:fareast\user1:farwest\user1

Befehlszeilenprobleme

In den folgenden Abschnitten werden häufige Befehlszeilenprobleme beschrieben. Erweitern Sie den Abschnitt, um empfohlene Lösungen anzuzeigen.

Ich habe die folgende Fehlermeldung erhalten: "Verwendungsfehler: Sie können keinen Dateipfad mit einer der Befehlszeilenoptionen angeben, die mehr als 256 Zeichen umfassen."

Ursache: Diese Fehlermeldung kann in einigen Fällen auch dann angezeigt werden, wenn Sie keinen langen Speicher- oder Dateipfad angeben, da die Pfadlänge basierend auf dem absoluten Pfad berechnet wird. Wenn Sie beispielsweise den **ScanState**.exe /o store Befehl aus C:\Programme\USMT40 ausführen, wird jedes Zeichen in C:\Programme\USMT40 der Länge von "store" hinzugefügt, um die Länge des Pfads abzurufen.

Auflösung: Stellen Sie sicher, dass die Gesamtlänge des Pfads 256 Zeichen nicht überschreitet. Die Gesamtpfadlänge umfasst den Speicherpfad plus das aktuelle Verzeichnis.

Ich habe die folgende Fehlermeldung erhalten: "USMT konnte die Protokolldateien nicht erstellen. Stellen Sie sicher, dass Sie über Schreibzugriff auf das Protokollverzeichnis verfügen."

Ursache: Wenn Sie die Tools ScanState oder LoadState über eine freigegebene Netzwerkressource ausführen, erhalten Sie diese Fehlermeldung, wenn Sie nicht angeben /l.

Auflösung: Um dieses Problem in diesem Szenario zu beheben, geben Sie die /l:ScanState.log Option oder /l:LoadState.log an.

XML-Dateiprobleme

In den folgenden Abschnitten werden häufige XML-Dateiprobleme beschrieben. Erweitern Sie den Abschnitt, um empfohlene Lösungen anzuzeigen.

Ich habe die /genconfig Option zum Erstellen einer Config.xml-Datei verwendet, aber ich sehe nur einige Anwendungen und Komponenten, die sich in MigApp.xml befinden. Warum enthält Config.xml nicht alle anwendungen?

Ursache:Config.xml nur Betriebssystemkomponenten, Anwendungen und benutzerdokumentabschnitte enthalten, die sich in beiden .xml Dateien befinden und auf dem Computer installiert sind, wenn Sie die /genconfig Option ausführen. Andernfalls werden diese Anwendungen und Komponenten nicht in der Config.xml-Datei angezeigt.

Auflösung: Installieren Sie alle gewünschten Anwendungen auf dem Computer, bevor Sie die /genconfig Option ausführen. Führen Sie dann ScanState.exe mit allen .xml-Dateien aus. Führen Sie beispielsweise den folgenden Befehl aus:

ScanState.exe /genconfig:Config.xml /i:MigDocs.xml /i:MigApp.xml /v:5 /l:ScanState.log

Ich habe Probleme mit einer benutzerdefinierten .xml Datei, die ich erstellt habe, und ich kann nicht überprüfen, ob die Syntax korrekt ist.

Auflösung: Sie können die XML-Schemadatei MigXML.xsd in Ihr XML-Erstellungstool laden. MigXML.xsd ist in USMT enthalten. Beispiele finden Sie im Visual Studio Development Center. Laden Sie dann Ihre .xml-Datei in das Erstellungstool, um festzustellen, ob ein Syntaxfehler vorliegt. Weitere Informationen zur Verwendung der XML-Elemente finden Sie in der USMT-XML-Referenz.

Ich verwende eine MigXML-Hilfsfunktion, aber die Migration funktioniert nicht wie erwartet. Gewusst wie dieses Problem beheben?

Ursache: In der Regel wird dieses Problem durch eine falsche Syntax verursacht, die in einer Hilfsfunktion verwendet wird. Sie erhalten einen Erfolgsrückgabecode, aber die Dateien, die Sie migrieren möchten, wurden nicht gesammelt oder angewendet oder nicht wie erwartet gesammelt oder angewendet.

Auflösung: Sie sollten das ScanState - oder LoadState-Protokoll entweder nach dem Komponentennamen, der die MigXML-Hilfsfunktion enthält, oder nach dem Titel der MigXML-Hilfsfunktion durchsuchen, damit Sie die zugehörige Warnung in der Protokolldatei finden können.

Migrationsprobleme

In den folgenden Abschnitten werden häufige Migrationsprobleme beschrieben. Erweitern Sie den Abschnitt, um empfohlene Lösungen anzuzeigen.

Dateien, die ich zum Ausschließen angegeben habe, werden noch migriert.

Ursache: Möglicherweise gibt es eine andere Regel, die die Dateien einschließt. Wenn es eine spezifischere Regel oder eine in Konflikt stehende Regel gibt, werden die Dateien in die Migration einbezogen.

Auflösung: Weitere Informationen finden Sie unter Konflikte und Rangfolge und im Abschnitt Diagnoseprotokoll in Protokolldateien.

Ich habe Regeln angegeben, um einen Ordner an einen bestimmten Speicherort auf dem Zielcomputer zu verschieben, aber er wurde nicht ordnungsgemäß migriert.

Ursache: Möglicherweise liegt ein Fehler in der XML-Syntax vor.

Auflösung: Sie können das USMT-XML-Schema (MigXML.xsd) verwenden, um die Migration .xml Dateien zu schreiben und zu überprüfen. Sehen Sie sich auch die XML-Beispiele in den folgenden Artikeln an:

Konflikte und Rangfolge

Ausschließen von Dateien und Einstellungen

Umleiten von Dateien und Einstellungen

Einschließen von Dateien und Einstellungen

Benutzerdefinierte XML-Beispiele

Nach Abschluss von LoadState wird der neue Desktophintergrund nicht mehr auf dem Zielcomputer angezeigt.

Es gibt drei typische Ursachen für dieses Problem.

Ursache: Einige Einstellungen wie Schriftarten, Desktophintergründe und Bildschirmschonereinstellungen werden von LoadState erst angewendet, nachdem der Zielcomputer neu gestartet wurde.

Auflösung: Um dieses Problem zu beheben, melden Sie sich ab, und melden Sie sich dann wieder an, um den migrierten Desktophintergrund anzuzeigen.

Ich habe MigApp.xml in die Migration einbezogen, aber einige PST-Dateien werden nicht migriert.

Ursache: Die MigApp.xml-Datei migriert nur die PST-Dateien, die mit Outlook-Profilen verknüpft sind.

Auflösung: Um PST-Dateien zu migrieren, die nicht mit Outlook-Profilen verknüpft sind, müssen Sie eine separate Migrationsregel erstellen, um diese Dateien zu erfassen.

USMT migriert das Startlayout nicht.

Beschreibung: Sie verwenden USMT, um Profile von einer Installation von Windows 10 zu einer anderen Installation von Windows 10 auf unterschiedlicher Hardware zu migrieren. Nach der Migration meldet sich der Benutzer auf dem neuen Gerät an und verfügt nicht über das Zuvor konfigurierte Startmenülayout.

Ursache: Eine Codeänderung im Startmenü mit Windows 10 Version 1607 und höher ist mit dieser USMT-Funktion nicht kompatibel.

Auflösung: Die folgende Problemumgehung ist verfügbar:

  1. Wenn der Benutzer angemeldet ist, sichern Sie das Startlayout mit dem folgenden Windows PowerShell Befehl. Sie können bei Bedarf einen anderen Pfad angeben:

    Export-StartLayout -Path "C:\Layout\user1.xml"

  2. Migrieren Sie das Profil des Benutzers mit USMT.

  3. Bevor sich der Benutzer auf dem neuen Gerät anmeldet, importieren Sie das Startlayout mit dem folgenden Windows PowerShell Befehl:

    Import-StartLayout -LayoutPath "C:\Layout\user1.xml" -MountPath %systemdrive%

Diese Problemumgehung ändert das Startlayout des Standardbenutzers. Die Problemumgehung lässt sich nicht auf Massenmigrationen oder Geräte mit mehreren Benutzern skalieren, kann aber möglicherweise einige Szenarien entsperren. Wenn sich andere Benutzer beim Gerät anmelden, sollten Sie layoutmodification.xml aus dem Standardbenutzerprofil löschen. Andernfalls verwenden alle Benutzer, die sich bei diesem Gerät anmelden, das importierte Startlayout.

Probleme bei der Offlinemigration

In den folgenden Abschnitten werden häufige Probleme bei der Offlinemigration beschrieben. Erweitern Sie den Abschnitt, um empfohlene Lösungen anzuzeigen.

Einige meiner Systemeinstellungen werden bei einer Offlinemigration nicht migriert.

Ursache: Einige Systemeinstellungen, z. B. Desktophintergründe und Netzwerkdrucker, werden bei einer Offlinemigration nicht unterstützt. Weitere Informationen finden Sie unter Was migriert USMT?

Auflösung: Bei einer Offlinemigration müssen diese Systemeinstellungen manuell wiederhergestellt werden.

Fehler beim ScanState-Tool mit Rückgabecode 26

Ursache: Eine häufige Ursache für den Rückgabecode 26 ist, dass ein temporäres Profil auf dem Quellcomputer aktiv ist. Dieses Profil wird c:\users\temp zugeordnet. Das ScanState-Protokoll zeigt eine MigStartupOfflineCaught-Ausnahme an, die die Meldung User profile duplicate SID error enthält.

Auflösung: Sie können den Computer neu starten, um das temporäre Profil zu entfernen, oder Sie können MIG_FAIL_ON_PROFILE_ERROR=0 festlegen, um den Fehler zu überspringen und das temporäre Profil auszuschließen.

Ein- und Ausschlussregeln für die Migration von Benutzerprofilen funktionieren offline nicht genauso wie online.

Ursache: Im Offlinemodus kann der DNS-Server nicht abgefragt werden, um die Zuordnung von Benutzername und SID aufzulösen.

Auflösung: Verwenden Sie eine Sicherheits-ID (SID), um einen Benutzer einzuschließen, wenn Sie das ScanState-Tool ausführen. Zum Beispiel:

ScanState.exe /ui:S1-5-21-124525095-708259637-1543119021*

Der wilde Karte (*) am Ende der SID migriert auch den SCHLÜSSEL SID_Classes.

Sie können auch Muster für SIDs verwenden, die generische Benutzer oder Gruppen identifizieren. Beispielsweise können Sie die /ue:*-500 Option verwenden, um die lokalen Administratorkonten auszuschließen. Weitere Informationen zu Windows-SIDs finden Sie unter Sicherheits-IDs.

Mein Skript zum Zurücksetzen des Datenträgers schlägt fehl, nachdem das ScanState-Tool auf einem 64-Bit-System ausgeführt wurde.

Ursache: Die HKLM-Registrierungsstruktur wird nicht entladen, nachdem die Ausführung des ScanState-Tools abgeschlossen wurde.

Auflösung: Starten Sie den Computer neu, oder entladen Sie die Registrierungsstruktur an der Eingabeaufforderung, nachdem die Ausführung des ScanState-Tools abgeschlossen wurde. Geben Sie beispielsweise an einer Eingabeaufforderung Folgendes ein:

reg.exe unload hklm\$dest$software

In den folgenden Abschnitten werden häufige Probleme bei der Migration mit harter Verknüpfung beschrieben. Erweitern Sie den Abschnitt, um empfohlene Lösungen anzuzeigen.

EFS-Dateien werden nicht auf der neuen Partition wiederhergestellt.

Ursache: EFS-Dateien können nicht in eine neue Partition mit einer harten Verknüpfung verschoben werden. Die /efs:hardlink Befehlszeilenoption gilt nur für Dateien, die auf derselben Partition migriert wurden.

Auflösung: Verwenden Sie die /efs:copyraw Befehlszeilenoption, um EFS-Dateien während der Migration zu kopieren, anstatt feste Links zu erstellen, oder kopieren Sie die EFS-Dateien manuell aus dem Festverknüpfungsspeicher.

Ursache: Der Migrationsspeicher enthält feste Links zu gesperrten Dateien.

Auflösung: Verwenden Sie das UsmtUtils-Tool, um den Speicher zu löschen oder den Namen des Speichers zu ändern. Geben Sie beispielsweise an einer Eingabeaufforderung Folgendes ein:

UsmtUtils.exe /rd <storedir>

Sie sollten auch den Computer neu starten.

Datensammlung

Wenn Sie Unterstützung vom Microsoft-Support benötigen, empfehlen wir Ihnen, die Informationen zu sammeln, indem Sie die Schritte unter Sammeln von Informationen mithilfe von TSS für Bereitstellungsprobleme ausführen.

Problembehandlung für das Migrationstool für den Benutzerstatus (User State Migration Tool, USMT)

Häufig gestellte Fragen

Rückgabecodes

UsmtUtils-Syntax