Freigeben über

Häufig auftretende Probleme mit dem Migrationstool für den Benutzerstatus (USER State Migration Tool, USMT)

  • Artikel

In den folgenden Abschnitten werden häufig auftretende Probleme erläutert, die beim Ausführen der USMT 10.0-Tools auftreten können. USMT erzeugt Protokolldateien, die alle fehler, die während des Migrationsprozesses aufgetreten sind, ausführlicher beschreiben. Diese Protokolle können verwendet werden, um Migrationsfehler zu beheben.

Allgemeine Richtlinien für die Identifizierung von Migrationsproblemen

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

  • Überprüfen Sie die Protokolle ScanState, LoadState und UsmtUtils, um die genauen USMT-Fehlermeldungen und Fehlermeldungen der Windows-Anwendungsprogrammierschnittstelle® (API) abzurufen. 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, in dem <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 ScanState- und LoadState-Protokolle an, warum eine USMT-Migration fehlschlägt. Es wird empfohlen, beim Testen der Migration die /v:5 Option zu verwenden. Diese Ausführlichkeitsstufe kann in einer Produktionsmigration angepasst werden; Durch die Verringerung der Ausführlichkeitsstufe kann es jedoch schwieriger werden, Fehler zu diagnostizieren, die während der Produktionsmigration auftreten. Sie können eine Ausführlichkeitsstufe höher als 5 verwenden, wenn die Ausgabe der Protokolldateien zu einem Debugger wechseln soll.

    Notiz

    Wenn Sie die Tools "ScanState " und "LoadState " mit der /v:5 Option ausführen, wird eine detaillierte Protokolldatei erstellt. Obwohl diese Option die Protokolldatei groß macht, können Sie mit den 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 ein Statusprotokoll mit der /Progress Option zum Überwachen der Migration.

  • Für die Quell- und Zielcomputer erhalten Sie Betriebssysteminformationen und Versionen von Anwendungen wie Internet Explorer und anderen relevanten Programmen. Überprüfen Sie dann die genauen Schritte, die zum Reproduzieren des Problems erforderlich sind. Diese Informationen helfen Ihnen möglicherweise, 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, werden einige Daten von USMT möglicherweise nicht migriert. Wenn Beispielsweise Microsoft Outlook® geöffnet ist, migriert USMT möglicherweise keine PST-Dateien.

    Notiz

    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 auftritt, die nicht migriert wurde.

Probleme mit Benutzerkonten

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

Ich habe Probleme beim Erstellen lokaler Konten auf dem Zielcomputer

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

Nicht alle Benutzerkonten wurden auf den Zielcomputer migriert.

Ursachen/Lösungen Für dieses Problem gibt es zwei mögliche Ursachen:

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

  1. Wählen Sie ">Alle Programme>starten" aus.

  2. Klicken Sie mit der rechten Maustaste auf Eingabeaufforderung.

  3. Wähle Als Administrator ausführen.

  4. Geben Sie den Befehl LoadState.exe oder ScanState.exe an.

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

Alle Benutzerkonten auf dem Computer, die nicht verwendet wurden, werden nicht migriert. Wenn Sie z. B. "User1" zum Computer hinzufügen, sich aber nie anmelden, migriert USMT das Benutzerkonto nicht.

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

Ursache: Der von Ihnen angegebene Befehl hat möglicherweise Konflikte ui und /ue Optionen. Wenn ein Benutzer mit der /ui Option und gleichzeitig mit den /ue Optionen /uel 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.

Lösung: Weitere Informationen zur gemeinsamen Verwendung der /ui Optionen finden /ue 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 des Benutzers übereinstimmt.

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

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

Ursache: Wenn Sie das ScanState-Tool während eines Migrationstests auf Ihrem Testcomputer ausführen und dann Benutzerprofile löschen, um das LoadState-Tool auf demselben Computer zu testen, ist möglicherweise ein konfliktierender Schlüssel in der Registrierung vorhanden. Wenn Sie den Net-Befehl verwenden , um ein Benutzerprofil zu entfernen, werden Ordner und Dateien gelöscht, die diesem Profil zugeordnet sind, aber nicht den Registrierungsschlüssel entfernen.

Lösung: Verwenden Sie zum Löschen eines Benutzerprofils das Element "Benutzerkonten" in Systemsteuerung. So korrigieren Sie ein unvollständiges Löschen 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 ProfileList.

  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 wurde.

Ursache: Das ScanState-Tool wurde mit der /EFS:copyraw Option zum Migrieren von verschlüsselten Dateien und EFS-Zertifikaten (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 dateiinhalten dieses Ordners entfernt.

Lösung: Bevor Sie das ScanState-Tool für eine Migration verwenden, die verschlüsselte Dateien und EFS-Zertifikate enthält, können Sie das Tool "Verschlüsselung" an der Eingabeaufforderung ausführen, um 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 mit dem Konto anmelden, das Sie zum Ausführen des LoadState-Tools 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.

Lö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 allgemeine 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 256 Zeichen überschreiten."

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

Lösung: Stellen Sie sicher, dass die Gesamtlänge des Pfads 256 Zeichen nicht überschreitet. Die Gesamtpfadlänge enthält den Speicherpfad sowie das aktuelle Verzeichnis.

Ich habe die folgende Fehlermeldung erhalten: "USMT konnte die Protokolldatei(n) nicht erstellen. Stellen Sie sicher, dass Sie Schreibzugriff auf das Protokollverzeichnis haben."

Ursache: Wenn Sie die ScanState- oder LoadState-Tools aus einer freigegebenen Netzwerkressource ausführen, wird diese Fehlermeldung angezeigt, wenn Sie nicht angeben/l.

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

XML-Dateiprobleme

In den folgenden Abschnitten werden allgemeine 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 gleichen Anwendungen?

Ursache: Config.xml enthält nur Betriebssystemkomponenten, Anwendungen und die Benutzerdokumentabschnitte, 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 datei Config.xml angezeigt.

Lö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.

Lö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 im 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 Problembehandlung?

Ursache: In der Regel wird dieses Problem durch falsche Syntax verursacht, die in einer Hilfsfunktion verwendet wird. Sie erhalten einen Erfolgsrücklaufcode, aber die Dateien, die Sie migrieren wollten, wurden nicht gesammelt oder angewendet, oder wurden nicht gesammelt oder angewendet, wie Sie es erwartet haben.

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

Migrationsprobleme

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

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

Ursache: Möglicherweise gibt es eine andere Regel, die die Dateien einschl. Wenn eine spezifischere Regel oder eine widersprüchliche Regel vorhanden ist, werden die Dateien in die Migration einbezogen.

Lösung: Weitere Informationen finden Sie im Abschnitt "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.

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

Konflikte und Rangfolge

Dateien und Einstellungen ausschließen

Umleiten von Dateien und Einstellungen

Einschließen von Dateien und Einstellungen

Beispiele für benutzerdefinierte XML-Dateien

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

Für dieses Problem gibt es drei typische Ursachen.

Ursache: Einige Einstellungen wie Schriftarten, Desktophintergründe und Bildschirmschonereinstellungen werden erst nach dem Neustart des Zielcomputers von LoadState angewendet.

Lö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.

Lö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 zum Migrieren von Profilen von einer Installation von Windows 10 zu einer anderen Installation von Windows 10 auf unterschiedlicher Hardware. Nach der Migration meldet sich der Benutzer auf dem neuen Gerät an und verfügt nicht über das zuvor konfigurierte Menü Layout.

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

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

  1. Wenn der Benutzer angemeldet ist, sichern Sie das Startlayout mithilfe des folgenden Windows PowerShell-Befehls. 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 mithilfe des folgenden Windows PowerShell-Befehls:

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

Diese Problemumgehung ändert das Startlayout des Standardbenutzers. Die Problemumgehung wird nicht auf Massenmigrationen oder Mehrbenutzergeräte skaliert, kann aber möglicherweise die Blockierung einiger Szenarien aufheben. 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 allgemeine Probleme bei der Offlinemigration beschrieben. Erweitern Sie den Abschnitt, um empfohlene Lösungen anzuzeigen.

Einige meiner Systemeinstellungen werden in einer Offlinemigration nicht migriert.

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

Lösung: In einer Offlinemigration müssen diese Systemeinstellungen manuell wiederhergestellt werden.

Das ScanState-Tool schlägt mit Rückgabecode 26 fehl.

Ursache: Eine häufige Ursache für rückgabecode 26 ist, dass ein temporäres Profil auf dem Quellcomputer aktiv ist. Dieses Profil ist c:\users\temp zugeordnet. Das ScanState-Protokoll zeigt eine MigStartupOfflineCaught-Ausnahme an, die den Fehler "Benutzerprofil duplizierte SID" enthält.

Lö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.

Regeln zum Einschließen und Ausschließen von Regeln für die Migration von Benutzerprofilen funktionieren nicht offline wie online

Ursache: Beim Offlinemodus kann der DNS-Server nicht abgefragt werden, um den Benutzernamen und die SID-Zuordnung aufzulösen.

Lösung: Verwenden Sie eine Sicherheits-ID (SID), um einen Benutzer einzuschließen, wenn das ScanState-Tool ausgeführt wird. Beispiel:

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

Die Platzhalterkarte (*) am Ende der SID migriert auch den SID_Classes Schlüssel.

Sie können auch Muster für SIDs verwenden, die generische Benutzer oder Gruppen identifizieren. Sie können beispielsweise 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 nach Abschluss der Ausführung des ScanState-Tools nicht entladen.

Lösung: Starten Sie den Computer neu, oder entladen Sie die Registrierungsstruktur an der Eingabeaufforderung, nachdem das ScanState-Tool die Ausführung abgeschlossen hat. Geben Sie beispielsweise an einer Eingabeaufforderung Folgendes ein:

reg.exe unload hklm\$dest$software

In den folgenden Abschnitten werden allgemeine Probleme bei der Migration von Hardlinks beschrieben. Erweitern Sie den Abschnitt, um empfohlene Lösungen anzuzeigen.

EFS-Dateien werden nicht in der neuen Partition wiederhergestellt.

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

Lösung: Verwenden Sie die /efs:copyraw Befehlszeilenoption, um EFS-Dateien während der Migration zu kopieren, anstatt feste Verknüpfungen zu erstellen, oder kopieren Sie die EFS-Dateien manuell aus dem Hardlinkspeicher.

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

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

UsmtUtils.exe /rd <storedir>

Sie sollten den Computer auch 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 beim Migrationstool für den Benutzerstatus (USMT)

Häufig gestellte Fragen

Rückgabecodes

UsmtUtils-Syntax