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:
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.xml und 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:
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 /i Optionen , /v und /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:
|
/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.xml und MigApp.xml auf den Config.xml Zielcomputer 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:
|
Ü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:
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 /ui Optionen , /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:
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 nicht, dass die Anmeldung instance.
Hinweis Die /uel Option ist bei Offlinemigrationen nicht gültig.
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 /uel
Optionen , /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:
|
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.