ScanState-Syntax

Der ScanState.exe Befehl wird mit dem Migrationstool für den Benutzerstatus (User State Migration Tool, USMT) verwendet, um den Quellcomputer zu überprüfen, die Dateien und Einstellungen zu erfassen und einen Speicher zu erstellen. In diesem Artikel werden die ScanState.exe Befehlssyntax und die damit verfügbaren Optionen erläutert.

Vor beginn

Notieren Sie sich vor dem Ausführen des ScanState.exe Befehls die folgenden Elemente:

  • Um sicherzustellen, dass alle Betriebssystemeinstellungen migriert werden, führen Sie in die ScanState.exe Befehle im Administratormodus aus einem Konto mit Administratoranmeldeinformationen aus.

  • Wenn der Migrationsspeicher verschlüsselt ist, ist ein Verschlüsselungsschlüssel oder ein Pfad zu einer Datei erforderlich, die den Verschlüsselungsschlüssel enthält. Notieren Sie sich unbedingt den Speicherort des Schlüssels oder der Schlüsseldatei, da diese Informationen an keiner Stelle im Migrationsspeicher gespeichert werden. Diese Informationen sind erforderlich, wenn der LoadState.exe Befehl ausgeführt wird, um den Migrationsspeicher zu entschlüsseln, oder wenn das Wiederherstellungsprogramm verwendet werden muss. Eine falsche oder fehlende Schlüssel- oder Schlüsseldatei führt zu einer Fehlermeldung.

  • Informationen zu den Softwareanforderungen für die Ausführung des ScanState.exe Befehls finden Sie unter USMT-Anforderungen.

  • Sofern nicht anders angegeben, verwenden Sie jede Option nur einmal, wenn Sie ein Tool in der Befehlszeile ausführen.

  • Domänenkonten können erfasst werden, ohne dass der Quellcomputer über Domänencontrollerzugriff verfügt. Diese Funktionalität ist ohne zusätzliche Konfiguration verfügbar.

  • In der Tabelle Inkompatible Befehlszeilenoptionen wird aufgeführt, welche Optionen zusammen verwendet werden können und welche Befehlszeilenoptionen nicht kompatibel sind.

  • Der Verzeichnisspeicherort, in dem der Migrationsspeicher gespeichert ist, wird von der Überprüfung ausgeschlossen. Wenn der Migrationsspeicher beispielsweise im Stammverzeichnis des Laufwerks D gespeichert wird, werden Laufwerk D und alle zugehörigen Unterverzeichnisse von der Überprüfung ausgeschlossen.

Syntax

In diesem Abschnitt werden die Syntax und die Verwendung der Befehlszeilenoptionen erläutert, die bei Verwendung des ScanState.exe Befehls verfügbar sind. Die Optionen können in beliebiger Reihenfolge angegeben werden. Wenn die Option einen Parameter enthält, kann entweder ein Doppelpunkt oder ein Leerzeichen verwendet werden.

Die ScanState.exe Syntax des Befehls lautet:

ScanState.exe [StorePath] [/apps] [/ppkg:FileName] [/i:[Path\]FileName] [/o] [/v:VerbosityLevel] [/nocompress] [/localonly] [/encrypt /key:KeyString|/keyfile:[Path\]FileName] [/l:[Path\]FileName] [/progress:[Path\]FileName] [/r:TimesToRetry] [/w:SecondsBeforeRetry] [/c] [/p] [/all] [/ui:[DomainName|ComputerName\]UserName] [/ue:[DomainName|ComputerName\]UserName] [/uel:NumberOfDays|YYYY/MM/DD|0] [/efs:abort|skip|decryptcopy|copyraw] [/genconfig:[Path\]FileName[/config:[Path\]FileName] [/?|Hilfe]

Um beispielsweise eine Config.xml Datei im aktuellen Verzeichnis zu erstellen, verwenden Sie Folgendes:

ScanState.exe /i:MigApp.xml /i:MigDocs.xml /genconfig:Config.xml /v:13

Verwenden Sie zum Erstellen eines verschlüsselten Speichers mithilfe der Config.xml Datei und der Standardmigration .xml Dateien Folgendes:

ScanState.exe \\server\share\migration\mystore /i:MigApp.xml /i:MigDocs.xml /o /config:Config.xml /v:13 /encrypt /key:"mykey"

Speicheroptionen

Command-Line Option Beschreibung
StorePath Gibt einen Ordner an, in dem Dateien und Einstellungen gespeichert werden. StorePath darf nicht sein C:\. Die StorePath-Option muss im ScanState.exe Befehl angegeben werden, außer bei Verwendung der /genconfig Option. Mehrere StorePath-Speicherorte können nicht angegeben werden.
/Apps Überprüft das Image auf Apps und schließt sie und die zugehörigen Registrierungseinstellungen ein.
/ppkg [<FileName>] Exportiert an einen bestimmten Dateispeicherort.
/o Erforderlich, um alle vorhandenen Daten im Migrationsspeicher oder Config.xml in der Migrationsdatei zu überschreiben. Falls nicht angegeben, schlägt der ScanState.exe Befehl fehl, wenn der Migrationsspeicher bereits Daten enthält. Diese Option kann nicht mehrmals in einer Befehlszeile verwendet werden.
/vsc Mit dieser Option kann der Volumeschattenkopiedienst gesperrte oder verwendete Dateien migrieren. Diese Befehlszeilenoption beseitigt die meisten Dateisperrungsfehler, die normalerweise im <Abschnitt ErrorControl> auftreten.

Diese Option wird nur mit der ausführbaren ScanState-Datei verwendet und kann nicht mit der /hardlink Option kombiniert werden.
/hardlink Ermöglicht die Erstellung eines Migrationsspeichers mit festem Link am angegebenen Speicherort. Die /nocompress Option muss mit der /hardlink -Option angegeben werden.
/encrypt [{/key:<KeyString> | /keyfile:<file>]} Verschlüsselt den Speicher mit dem angegebenen Schlüssel. Die Verschlüsselung ist standardmäßig deaktiviert. Bei dieser Option muss der Verschlüsselungsschlüssel auf eine der folgenden Arten angegeben werden:
  • /key: KeyString gibt den Verschlüsselungsschlüssel an. Wenn in KeyString ein Leerzeichen vorhanden ist, muss KeyString in Anführungszeichen (") eingeschlossen werden.
  • /keyfile: FilePathAndName gibt eine Textdatei (.txt) an, die den Verschlüsselungsschlüssel enthält.

KeyString sollte mindestens acht Zeichen lang sein, darf aber 256 Zeichen nicht überschreiten. Die /key Optionen und /keyfile können nicht in derselben Befehlszeile verwendet werden. Die /encrypt Optionen und /nocompress können nicht in derselben Befehlszeile verwendet werden.
Wichtig
Seien Sie vorsichtig, wenn Sie die /key Optionen oder keyfile verwenden. Beispielsweise hat jeder, der Zugriff auf Skripts hat, die den ScanState.exe Befehl mit diesen Optionen ausführen, auch Zugriff auf den Verschlüsselungsschlüssel.

Das folgende Beispiel zeigt den ScanState.exe Befehl und die /key Option:
ScanState.exe /i:MigDocs.xml /i:MigApp.xml \server\share\migration\mystore /encrypt /key:mykey
/encrypt:<EncryptionStrength> Die /encrypt Option akzeptiert einen Befehlszeilenparameter, um die Verschlüsselungsstärke zu definieren, die für die Verschlüsselung des Migrationsspeichers verwendet werden soll. Weitere Informationen zu unterstützten Verschlüsselungsalgorithmen finden Sie unter Migrationsspeicherverschlüsselung.
/nocompress Deaktiviert die Komprimierung von Daten und speichert die Dateien in einem ausgeblendeten Ordner namens "File" unter StorePath\USMT. Die Komprimierung ist standardmäßig aktiviert. Wenn Sie die /nocompress Option mit der /hardlink Option kombinieren, wird ein Migrationsspeicher mit festem Link generiert. Der unkomprimierte Speicher kann verwendet werden, um anzuzeigen, was USMT gespeichert hat, ein Problem zu beheben oder ein Antivirenprogramm für die Dateien auszuführen. Diese Option sollte nur in Testumgebungen verwendet werden. Microsoft empfiehlt die Verwendung eines komprimierten Speichers während der Produktionsmigrationen, es sei denn, die /nocompress Option wird mit der /hardlink Option kombiniert.

Die /nocompress Optionen und /encrypt können nicht zusammen in einer Anweisung in der Befehlszeile verwendet werden. Wenn jedoch ein nicht komprimierter Speicher migriert wird, migriert der LoadState.exe Befehl jede Datei direkt aus dem Speicher an den richtigen Speicherort auf dem Zielcomputer ohne temporären Speicherort.

Zum Beispiel:
ScanState.exe /i:MigDocs.xml /i:MigApp.xml \server\share\migration\mystore /nocompress

Ausführen des ScanState-Befehls auf einem Windows-Offlinesystem

Der ScanState.exe Befehl kann in Windows Preinstallation Environment (WinPE) ausgeführt werden. Darüber hinaus unterstützt USMT Migrationen von früheren Installationen von Windows, die in Windows.old-Verzeichnissen enthalten waren. Das Offlineverzeichnis kann ein Windows-Verzeichnis sein, wenn der ScanState.exe Befehl in WinPE ausgeführt wird, oder ein Windows.old-Verzeichnis , wenn der ScanState.exe Befehl in Windows ausgeführt wird.

Die Ausführung des ScanState.exe Befehls auf einem Windows-Offlineimage bietet mehrere Vorteile, darunter:

  • Verbesserte Leistung.

    Da WinPE ein schlankes Betriebssystem ist, werden weniger Dienste ausgeführt. In dieser Umgebung hat der ScanState.exe Befehl mehr Zugriff auf die lokalen Hardwareressourcen, sodass ScanState Migrationsvorgänge schneller ausführen kann.

  • Vereinfachter End-to-End-Bereitstellungsprozess.

    Die Migration von Daten von Windows.old vereinfacht den End-to-End-Bereitstellungsprozess, indem der Migrationsprozess nach der Installation des neuen Betriebssystems erfolgen kann.

  • Verbesserter Migrationserfolg.

    Die Erfolgsrate der Migration wird erhöht, weil:

    • Dateien sind offline nicht für die Bearbeitung gesperrt.
    • WinPE bietet Administratorzugriff auf Dateien im Windows-Offlinedateisystem, wodurch der Zugriff auf Administratorebene auf das Onlinesystem entfällt.

  • Möglichkeit zum Wiederherstellen eines von einem Computer, der nicht gestartet wird.

    Es ist möglicherweise möglich, Daten von einem Computer, der nicht startet, wiederherzustellen und zu migrieren.

Optionen für die Offlinemigration

Command-Line Option Definition
/offline:"pfad zu einer Offline.xml datei" Diese Option wird verwendet, um einen Pfad zu einer Offline -.xml-Datei zu definieren, die möglicherweise andere Offlinemigrationsoptionen angeben kann. Beispiel: Ein Offline-Windows-Verzeichnis oder eine Umleitung von Domänen oder Ordnern, die für die Migration erforderlich sind.
/offlinewindir:"Pfad zu einem Windows-Verzeichnis" Diese Option gibt das Windows-Offlineverzeichnis an, aus dem der Befehl den ScanState.exe Benutzerzustand erfasst. Das Offlineverzeichnis kann Windows.old sein, wenn der ScanState.exe Befehl in Windows ausgeführt wird, oder ein Windows-Verzeichnis, wenn der ScanState.exe Befehl in WinPE ausgeführt wird.
/offlinewinold:"Windows.old-Verzeichnis" Diese Befehlszeilenoption aktiviert den Offlinemigrationsmodus und startet die Migration vom angegebenen Speicherort aus. Diese Option ist nur für die Verwendung in Windows.old-Migrationsszenarien vorgesehen, in denen die Migration aus einem Windows.old-Verzeichnis erfolgt.

Optionen für Migrationsregel

USMT bietet die folgenden Optionen, um anzugeben, welche Dateien migriert werden sollen.

Command-Line Option Beschreibung
/i:[Pfad]Dateiname (include)

Gibt eine .xml-Datei an, die Regeln enthält, die definieren, welchen Benutzer-, Anwendungs- oder Systemstatus migriert werden soll. Diese Option kann mehrmals angegeben werden, um alle .xml -Dateien (MigApp.xml, MigDocs.xmlund alle benutzerdefinierten .xml Dateien, die erstellt werden) einzuschließen. Der Pfad kann entweder ein relativer oder vollständiger Pfad sein. Wenn die Path-Variable nicht angegeben ist, muss sich FileName im aktuellen Verzeichnis befinden. Weitere Informationen dazu, welche Dateien angegeben werden sollen, finden Sie im Abschnitt "XML-Dateien" des Artikels Häufig gestellte Fragen .
/genconfig:[Path]FileName ( Config.xmlgenerieren)

Generiert die optionale Config.xml Datei, erstellt aber keinen Migrationsspeicher. Um sicherzustellen, dass diese Datei alles enthält, was migriert werden muss, erstellen Sie diese Datei auf einem Quellcomputer, der alle folgenden Elemente enthält:
  • Komponenten
  • applications
  • settings
auf den Zielcomputern vorhanden ist. Darüber hinaus sollten die anderen Migrations -.xml Dateien mit der Option /i angegeben werden, wenn diese Option angegeben wird.

Nachdem diese Datei erstellt wurde, kann sie mit dem ScanState.exe Befehl mithilfe der Option /config verwendet werden.

Die einzigen Optionen, die mit dieser Option angegeben werden können, sind die /iOptionen , /vund /l . StorePath kann nicht angegeben werden, da mit der /genconfig Option kein Speicher erstellt wird. Der Pfad kann entweder ein relativer oder vollständiger Pfad sein. Wenn die Path-Variable nicht angegeben ist, wird FileName im aktuellen Verzeichnis erstellt.

Beispiele:
  • Im folgenden Beispiel wird eine Config.xml Datei im aktuellen Verzeichnis erstellt:
    ScanState.exe /i:MigApp.xml /i:MigDocs.xml /genconfig:Config.xml /v:13
/config:[Path]FileName Gibt die Config.xml Datei an, die der ScanState.exe Befehl zum Erstellen des Speichers verwenden soll. Diese Option kann nicht mehrmals in der Befehlszeile verwendet werden. Der Pfad kann entweder ein relativer oder vollständiger Pfad sein. Wenn die Path-Variable nicht angegeben ist, muss sich FileName im aktuellen Verzeichnis befinden.

Im folgenden Beispiel wird ein Speicher mit den Config.xml Dateien MigDocs.xml, und MigApp.xml erstellt:
ScanState.exe \server\share\migration\mystore /config:Config.xml /i:MigDocs.xml /i:MigApp.xml /v:13 /l:ScanState.log

Im folgenden Beispiel werden die Dateien und Einstellungen mithilfe der Dateien , MigDocs.xmlund MigApp.xml auf den Config.xmlZielcomputer migriert:
LoadState.exe \server\share\migration\mystore /config:Config.xml /i:MigDocs.xml /i:MigApp.xml /v:13 /l:LoadState.log
/auto:path to script files Mit dieser Option können Sie den Speicherort der Standarddateien.xml angeben. Wenn kein Pfad angegeben wird, verweist USMT auf das Verzeichnis, in dem sich die USMT-Binärdateien befinden. Die /auto Option hat die gleiche Auswirkung wie die Verwendung der folgenden Optionen: /i: MigDocs.xml /i:MigApp.xml /v:5.
/genmigxml:path to a file Diese Option gibt an, dass der Befehl die ScanState.exe Dokumentsuche verwenden soll, um eine .xml Datei zu erstellen und zu exportieren, die definiert, wie alle Dateien auf dem Computer migriert werden, auf dem der ScanState.exe Befehl ausgeführt wird.
/localonly Migriert nur Dateien, die auf dem lokalen Computer gespeichert sind, unabhängig von den Regeln im .xml Dateien, die in der Befehlszeile angegeben sind. Diese Option sollte verwendet werden, um die Daten von Wechseldatenträgern auf dem Quellcomputer auszuschließen und wenn netzwerklaufwerke auf dem Quellcomputer zugeordnet sind. Beispiele für Wechseldatenträger sind USB-Speichersticks (UFDs) und einige externe Festplatten. Wenn die /localonly Option nicht angegeben ist, kopiert der ScanState.exe Befehl Dateien von diesen Wechseldatenträgern oder Netzlaufwerken in den Speicher.

/localonly schließt alles aus, was vom Betriebssystem nicht als Festplattenlaufwerk angesehen wird. In einigen Fällen werden große externe Festplatten als Festplattenlaufwerke betrachtet. Diese Laufwerke können mithilfe einer benutzerdefinierten .xml-Datei explizit von der Migration ausgeschlossen werden. Weitere Informationen zum Ausschließen aller Dateien auf einem bestimmten Laufwerk finden Sie unter Ausschließen von Dateien und Einstellungen.

Die /localonly Befehlszeilenoption schließt Daten in die Migration ein oder aus, wie an den folgenden Speicherorten angegeben:
  • Wechseldatenträger wie ein USB-Speicherstick – Ausgeschlossen
  • Netzlaufwerke – Ausgeschlossen
  • Festplattenlaufwerke – enthalten

Überwachungsoptionen

USMT bietet mehrere Optionen, die verwendet werden können, um Probleme zu analysieren, die während der Migration auftreten.

Hinweis

Das ScanState-Protokoll wird standardmäßig erstellt, aber der Name und Speicherort des Protokolls können mit der Option /l angegeben werden.

Command-Line Option Beschreibung
/listfiles:<FileName> Die /listfiles Befehlszeilenoption kann mit dem ScanState.exe Befehl verwendet werden, um eine Textdatei zu generieren, die alle in der Migration enthaltenen Dateien auflistet.
/l:[Pfad]Dateiname Gibt den Speicherort und den Namen des ScanState-Protokolls an.

Die Protokolldateien können nicht in StorePath gespeichert werden. Der Pfad kann entweder ein relativer oder vollständiger Pfad sein. Wenn die Path-Variable nicht angegeben ist, wird das Protokoll im aktuellen Verzeichnis erstellt. Die /v Option kann verwendet werden, um die Ausgabemenge anzupassen.

Wenn der ScanState.exe Befehl von einer freigegebenen Netzwerkressource ausgeführt wird, muss die /l Option angegeben werden, oder USMT schlägt mit dem folgenden Fehler fehl:

USMT konnte die Protokolldateien nicht erstellen.

Um dieses Problem zu beheben, stellen Sie sicher, dass Sie die /l Option angeben, wenn Sie von einer freigegebenen Netzwerkressource aus ausführen ScanState.exe .
/v:<VerbosityLevel> (Ausführlichkeit)

Aktiviert die ausführliche Ausgabe in der ScanState-Protokolldatei . Der Standardwert ist 0.

VerbosityLevel kann auf eine der folgenden Ebenen festgelegt werden:
  • 0 – Nur die Standardfehler und -warnungen sind aktiviert.
  • 1 – Aktiviert die ausführliche Ausgabe.
  • 4 – Aktiviert die Fehler- und Statusausgabe.
  • 5 – Aktiviert die ausführliche Ausgabe und die Statusausgabe.
  • 8 – Aktiviert die Fehlerausgabe an einen Debugger.
  • 9 – Aktiviert die ausführliche Ausgabe an einen Debugger.
  • 12 – Aktiviert die Fehler- und Statusausgabe an einen Debugger.
  • 13 – Aktiviert ausführliche Ausgabe, Status und Debuggerausgabe.

Zum Beispiel:
ScanState.exe \server\share\migration\mystore /v:13 /i:MigDocs.xml /i:MigApp.xml
/progress:[Path]FileName Erstellt das optionale Statusprotokoll. Die Protokolldateien können nicht in StorePath gespeichert werden. Der Pfad kann entweder ein relativer oder vollständiger Pfad sein. Wenn die Path-Variable nicht angegeben ist, wird FileName im aktuellen Verzeichnis erstellt.

Zum Beispiel:
ScanState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore /progress:Progress.log /l:scanlog.log
/c Wenn diese Option angegeben ist, wird der ScanState.exe Befehl weiterhin ausgeführt, auch wenn nicht schwerwiegende Fehler auftreten. Alle Dateien oder Einstellungen, die einen Fehler verursachen, werden im Statusprotokoll protokolliert. Wenn z. B. eine große Datei vorhanden ist, die nicht in den Speicher passt, protokolliert der ScanState.exe Befehl einen Fehler und führt die Migration aus. Wenn eine Datei geöffnet ist oder von einer Anwendung verwendet wird, kann USMT die Datei möglicherweise nicht migrieren und protokolliert einen Fehler. Ohne die /c Option wird der ScanState.exe Befehl beim ersten Fehler beendet.

Der <ErrorControl-Abschnitt> in der Config.xml Datei kann verwendet werden, um anzugeben, welche Datei- oder Registrierungs-Lese-/Schreibfehler sicher ignoriert werden können und welche dazu führen können, dass die Migration fehlschlägt. Dieser Vorteil in der Config.xml Datei ermöglicht es der /c Befehlszeilenoption, alle Eingabe-/Ausgabefehler (E/A) in der Umgebung sicher zu überspringen. Darüber hinaus generiert die Option /genconfig jetzt einen ErrorControl-Beispielabschnitt><, der durch Angeben von Fehlermeldungen und gewünschtem Verhalten in der Config.xml Datei aktiviert wird.
/r:<TimesToRetry> (Wiederholen)

Gibt die Anzahl der Wiederholungsversuche an, wenn beim Speichern des Benutzerzustands auf einem Server ein Fehler auftritt. Der Standardwert ist dreimal. Diese Option ist in Umgebungen nützlich, in denen die Netzwerkkonnektivität nicht zuverlässig ist.

Wenn der Benutzerzustand gespeichert ist, kann die Option keine Daten wiederherstellen, die /r aufgrund eines Netzwerkhardwarefehlers verloren gehen, z. B. aufgrund eines fehlerhaften oder getrennten Netzwerkkabels, oder wenn eine VPN-Verbindung (Virtual Private Network) fehlschlägt. Die Wiederholungsoption ist für große, ausgelastete Netzwerke vorgesehen, bei denen die Konnektivität zufriedenstellend ist, aber die Kommunikationslatenz ein Problem darstellt.
/w:<SecondsBeforeRetry> (Warten)

Gibt die Zeit in Sekunden an, die gewartet werden soll, bevor ein Netzwerkdateivorgang wiederholt wird. Der Standardwert ist 1 Sekunde.
/p:<pathToFile> Wenn der ScanState.exe Befehl ausgeführt wird, wird eine .xml Datei im angegebenen Pfad erstellt. Diese .xml-Datei enthält verbesserte Speicherplatzschätzungen für den Migrationsspeicher. Das folgende Beispiel zeigt, wie Sie diese .xml-Datei erstellen:
ScanState.exe C:\MigrationLocation [additional parameters]
/p:"C:\MigrationStoreSize.xml"

Weitere Informationen finden Sie unter Schätzen der Größe des Migrationsspeichers.

Um die Funktionalität vorhandener Anwendungen oder Skripts, die das vorherige Verhalten von USMT erfordern, beizubehalten, kann die /p Option ohne Angabe von "pathtoafile" in USMT verwendet werden. Wenn nur die /p Option angegeben wird, werden die Speicherplatzschätzungen auf die gleiche Weise wie bei USMT 3.x-Releases erstellt.
/? oder /help Zeigt die Hilfe an der Befehlszeile an.

Benutzeroptionen

Standardmäßig werden alle Benutzer migriert. Die einzige Möglichkeit, anzugeben, welche Benutzer ein- und ausgeschlossen werden sollen, ist die Verwendung der folgenden Optionen. Benutzer können bei der Migration .xml Dateien oder der Verwendung der Config.xml Datei nicht ausgeschlossen werden. Weitere Informationen finden Sie unter Identifizieren von Benutzern und Migrieren von Benutzerkonten.

Command-Line Option Beschreibung
/alle Migriert alle Benutzer auf dem Computer.

USMT migriert alle Benutzerkonten auf dem Computer, es sei denn, ein Konto wird ausdrücklich mit den /ue Optionen oder /uel ausgeschlossen. Aus diesem Grund muss diese Option nicht in der Befehlszeile angegeben werden. Wenn die /all Option jedoch angegeben ist, können die /uiOptionen , /ue oder /uel nicht auch angegeben werden.
/ui:<DomainName>\<UserName>
or
/ui:<ComputerName>\<LocalUserName>		 (Benutzer einschließen)

Migriert die angegebenen Benutzer. Standardmäßig sind alle Benutzer in die Migration einbezogen. Daher ist diese Option nur hilfreich, wenn sie mit den /ue Optionen oder /uel verwendet wird. Es können mehrere /ui Optionen angegeben werden, aber die /ui Option kann nicht mit der /all Option verwendet werden. DomainName und UserName können das Platzhalterzeichen (*) enthalten. Wenn ein Benutzername angegeben wird, der Leerzeichen enthält, muss er in Anführungszeichen (") eingeschlossen werden.
Hinweis
Wenn ein Benutzer für die Aufnahme mit der /ui Option angegeben und auch angegeben wird, dass er mit den /ue Optionen oder /uel ausgeschlossen werden soll, wird der Benutzer in die Migration einbezogen.

Zum Beispiel:
  • Um nur User2 aus der Fabrikam-Domäne einzuschließen, geben Sie Folgendes ein:

    /ue:*\* /ui:fabrikam\user2

  • Um alle Benutzer aus der Fabrikam-Domäne und nur die Benutzerkonten aus anderen Domänen zu migrieren, die in den letzten 30 Tagen aktiv oder anderweitig geändert wurden, geben Sie Folgendes ein:

    /uel:30 /ui:fabrikam\*

    In diesem Beispiel wird ein Benutzerkonto aus der Domäne Contoso, das zuletzt vor zwei Monaten geändert wurde, nicht migriert.

Weitere Beispiele finden Sie in den Beschreibungen der /ue Optionen und /ui in dieser Tabelle.
/uel:<NumberOfDays>
or
/uel:<JJJJ/MM/TT>
or
/uel:0		 (Benutzerausschluss basierend auf der letzten Anmeldung)

Migriert die Benutzer, die sich innerhalb des angegebenen Zeitraums auf dem Quellcomputer angemeldet haben, basierend auf dem Datum der letzten Änderung der Ntuser.dat-Datei auf dem Quellcomputer. Die /uel Option fungiert als Includeregel. Beispielsweise migriert die /uel:30 Option Benutzer, die sich innerhalb der letzten 30 Tage ab dem Datum der Ausführung des ScanState.exe Befehls angemeldet haben oder deren Konto geändert wurde.

Die Anzahl der Tage oder das Datum kann angegeben werden. Diese Option kann nicht mit der /all Option verwendet werden. USMT ruft die letzten Anmeldeinformationen vom lokalen Computer ab, sodass der Computer beim Ausführen dieser Option nicht mit dem Netzwerk verbunden werden muss. Wenn sich ein Domänenbenutzer bei einem anderen Computer anmeldet, berücksichtigt USMT außerdem diese Anmeldeinstanz nicht.
Hinweis
Die /uel Option ist bei Offlinemigrationen nicht gültig.
  • /uel:0 migriert alle Benutzer, die derzeit angemeldet sind.
  • /uel:90 migriert Benutzer, die sich innerhalb der letzten 90 Tage angemeldet haben oder deren Konten anderweitig geändert wurden.
  • /uel:1 migriert Benutzer, deren Konto innerhalb der letzten 24 Stunden geändert wurde.
  • /uel:2020/2/15 migriert Benutzer, die sich am 15. Februar 2020 oder danach angemeldet oder geändert wurden.

Zum Beispiel:
ScanState.exe /i:MigApp.xml /i:MigDocs.xml \\server\share\migration\mystore /uel:0
/ue:<DomainName>\<UserName>
– oder –

/ue:<ComputerName>\<LocalUserName>		 (Benutzer ausschließen)

Schließt die angegebenen Benutzer von der Migration aus. Es können mehrere /ue Optionen angegeben werden. Diese Option kann nicht mit der /all Option verwendet werden. <DomainName> und <UserName> können das Platzhalterzeichen (*) enthalten. Wenn ein Benutzername angegeben wird, der Leerzeichen enthält, muss er in Anführungszeichen (") eingeschlossen werden.

Zum Beispiel:
ScanState.exe /i:MigDocs.xml /i:MigApp.xml \\server\share\migration\mystore /ue:contoso\user1

Verwenden von "/ui" und "/ue"

Die folgenden Beispiele gelten für die /ui Optionen und /ue . Die /ue Option kann durch die /ui Option ersetzt werden, um die angegebenen Benutzer einzuschließen und nicht auszuschließen.

Verhalten Befehl
Schließen Sie den Benutzer mit dem Namen User One in der Domäne Fabrikam aus. /ue:"fabrikam\user one"
Schließen Sie den Benutzer mit dem Namen User1 in der Fabrikam-Domäne aus. /ue:fabrikam\user1
Schließen Sie den lokalen Benutzer mit dem Namen User1 aus. /ue:%computername%\user1
Schließen Sie alle Domänenbenutzer aus. /ue:Domain\*
Schließen Sie alle lokalen Benutzer aus. /ue:%computername%\*
Schließen Sie Benutzer in allen Domänen mit den Namen User1, User2 usw. aus. /ue:*\user*

Gemeinsames Verwenden der Optionen

Die /uelOptionen , /ue und /ui können zusammen verwendet werden, um nur die Benutzer zu migrieren, die migriert werden müssen.

Die /ui Option hat Vorrang vor den /ue Optionen und /uel . Wenn ein Benutzer für die Aufnahme mit der /ui Option angegeben und auch angegeben wird, dass er mit den /ue Optionen oder /uel ausgeschlossen werden soll, wird der Benutzer in die Migration einbezogen. Wenn /ui:contoso\* /ue:contoso\user1 beispielsweise angegeben ist, wird User1 migriert, da die /ui Option Vorrang vor der /ue Option hat.

Die /uel Option hat Vorrang vor der /ue Option. Wenn sich ein Benutzer innerhalb des durch die /uel Option festgelegten zeitraums angemeldet hat, wird das Profil dieses Benutzers auch dann migriert, wenn er mithilfe der /ue Option ausgeschlossen wird. Wenn /ue:fixed\user1 /uel:14 beispielsweise angegeben ist, wird User1 migriert, wenn er sich innerhalb der letzten 14 Tage am Computer angemeldet hat.

Verhalten Befehl
Schließen Sie nur User2 aus der Fabrikam-Domäne ein, und schließen Sie alle anderen Benutzer aus. /ue:*\* /ui:fabrikam\user2
Schließen Sie nur den lokalen Benutzer mit dem Namen User1 ein, und schließen Sie alle anderen Benutzer aus. /ue:*\* /ui:user1
Schließen Sie nur die Domänenbenutzer von Contoso mit Ausnahme von Contoso\User1 ein. Dieses Verhalten kann nicht mit einem einzelnen Befehl abgeschlossen werden. Geben Sie stattdessen die folgenden Befehle an, um diese Gruppe von Benutzern zu migrieren:
  • Geben Sie in der ScanState.exe Befehlszeile Folgendes ein:
    /ue:*\* /ui:contoso\*
  • Geben Sie in der LoadState.exe Befehlszeile Folgendes ein:
    /ue:contoso\user1
Schließen Sie nur lokale (nicht domänenbezogene) Benutzer ein. /ue:*\* /ui:%computername%\*

Verschlüsselte Dateioptionen

Die folgenden Optionen können verwendet werden, um verschlüsselte Dateien zu migrieren. In allen Fällen schlägt USMT standardmäßig fehl, wenn eine verschlüsselte Datei gefunden wird, es sei denn, die /efs Option ist angegeben. Um verschlüsselte Dateien zu migrieren, muss das Standardverhalten geändert werden.

Weitere Informationen finden Sie unter Migrieren von EFS-Dateien und -Zertifikaten.

Hinweis

EFS-Zertifikate werden während der Migration automatisch migriert. Daher sollte die /efs:copyraw Option mit dem ScanState.exe Befehl zum Migrieren der verschlüsselten Dateien angegeben werden.

Achtung

Seien Sie beim Migrieren verschlüsselter Dateien vorsichtig. Wenn eine verschlüsselte Datei migriert wird, ohne auch das Zertifikat zu migrieren, können Endbenutzer nach der Migration nicht mehr auf die Datei zugreifen.

Command-Line Option Erläuterung
/efs:hardlink Erstellt eine feste Verknüpfung mit der EFS-Datei, anstatt sie zu kopieren. Verwenden Sie nur mit den /hardlink Optionen und /nocompress .
/efs:abort Führt dazu, dass der ScanState.exe Befehl mit einem Fehlercode fehlschlägt, wenn auf dem Quellcomputer eine EFS-Datei (Encrypting File System) gefunden wird. Standardmäßig aktiviert.
/efs:skip Bewirkt, dass der ScanState.exe Befehl EFS-Dateien ignoriert.
/efs:decryptcopy Bewirkt, dass der ScanState.exe Befehl die Datei nach Möglichkeit vor dem Speichern im Migrationsspeicher entschlüsselt und fehlschlägt, wenn die Datei nicht entschlüsselt werden kann. Wenn der ScanState.exe Befehl erfolgreich ist, wird die Datei im Migrationsspeicher unverschlüsselt, und sobald der LoadState.exe Befehl ausgeführt wird, wird die Datei auf den Zielcomputer kopiert.
/efs:copyraw Bewirkt, dass der ScanState.exe Befehl die Dateien im verschlüsselten Format kopiert. Auf die Dateien kann auf dem Zielcomputer nicht zugegriffen werden, bis die EFS-Zertifikate migriert wurden. EFS-Zertifikate werden automatisch migriert. UsMT schlägt jedoch standardmäßig fehl, wenn eine verschlüsselte Datei gefunden wird, es sei denn, die /efs Option ist angegeben. Daher sollte die /efs:copyraw Option mit dem ScanState.exe Befehl zum Migrieren der verschlüsselten Datei angegeben werden. Wenn der LoadState.exe Befehl ausgeführt wird, werden die verschlüsselte Datei und das EFS-Zertifikat automatisch migriert.

Zum Beispiel:
ScanState.exe /i:MigDocs.xml /i:MigApp.xml \server\share\migration\mystore /efs:copyraw
Wichtig
Alle Dateien müssen verschlüsselt werden, wenn der übergeordnete Ordner verschlüsselt ist. Wenn das Verschlüsselungsattribut für eine Datei in einem verschlüsselten Ordner entfernt wird, wird die Datei während der Migration mit den Anmeldeinformationen des Kontos verschlüsselt, das zum Ausführen des LoadState-Tools verwendet wird. Weitere Informationen finden Sie unter Migrieren von EFS-Dateien und -Zertifikaten.

Inkompatible Befehlszeilenoptionen

In der folgenden Tabelle ist angegeben, welche Befehlszeilenoptionen nicht mit dem ScanState.exe Befehl kompatibel sind. Wenn der Tabelleneintrag für eine bestimmte Kombination einen ✅aufweist, sind die Optionen kompatibel und können zusammen verwendet werden. Das ❌ Symbol bedeutet, dass die Optionen nicht kompatibel sind. Die /nocompress Option kann beispielsweise nicht mit der /encrypt Option verwendet werden.

Command-Line Option /keyfile /nocompress /genconfig /alle
/Ich ✅ ✅ ✅ ✅
/o ✅ ✅ ✅ ✅
/v ✅ ✅ ✅ ✅
/nocompress ✅ ✅ ✅ n. a.
/localonly ✅ ✅ ❌ ✅
/Schlüssel ❌ ✅ ❌ ✅
/verschlüsseln Erforderlich* ❌ ❌ ✅
/keyfile n. a. ✅ ❌ ✅
/l ✅ ✅ ✅ ✅
/listfiles ✅ ✅ ❌ ✅
/Fortschritt ✅ ✅ ❌ ✅
/r ✅ ✅ ❌ ✅
/w ✅ ✅ ❌ ✅
/c ✅ ✅ ❌ ✅
/p ✅ ✅ ❌ n. a.
/alle ✅ ✅ ❌ ✅
/Benutzeroberfläche ✅ ✅ ❌ ❌
/ue ✅ ✅ ❌ ❌
/uel ✅ ✅ ❌ ❌
/efs:<option> ✅ ✅ ❌ ✅
/genconfig ✅ ✅ n. a. ✅
/config ✅ ✅ ❌ ✅
<StorePath> ✅ ✅ ❌ ✅

Hinweis

Entweder die /key -Option oder /keyfile die -Option muss mit der /encrypt -Option angegeben werden.