LoadState-Syntax
In diesem Thema werden die LoadState-Befehlssyntax und -Optionen beschrieben.
Inhalt dieses Themas
Vorbemerkungen
Syntax
Speicheroptionen
Migrationsregeloptionen
Überwachungsoptionen
Benutzeroptionen
Inkompatible Befehlszeilenoptionen
Vorbemerkungen
Beachten Sie vor dem Ausführen des Befehls LoadState Folgendes:
Um sicherzustellen, dass alle Betriebssystemeinstellungen migriert werden, empfehlen wir, die LoadState-Befehle im Verwaltungsmodus mit einem Konto mit Administratoranmeldeinformationen auszuführen.
Informationen zu den Softwareanforderungen für die Ausführung des Befehls LoadState finden Sie unter USMT-Anforderungen.
Nachdem Sie den Befehl LoadState ausgeführt haben, sollten Sie sich abmelden. Einige Einstellungen (z. B. Schriftarten, Hintergrundbild und Bildschirmschonereinstellungen) werden erst wirksam, wenn sich der Benutzer das nächste Mal anmeldet.
Sofern nichts anderes angegeben ist, kann jede Option beim Ausführen eines Tools in der Befehlszeile nur einmal verwendet werden.
LoadState muss zum Anwenden von Domänenprofilen keinen Zugriff auf den Domänencontroller haben. Diese Funktion ist ohne zusätzliche Konfiguration verfügbar. Es ist nicht erforderlich, dass der Quell-PC beim Sammeln des Benutzerprofils mit ScanState Zugriff auf den Domänencontroller hatte. Auf Domänenprofile kann aber erst zugegriffen werden, wenn der Ziel-PC der Domäne hinzugefügt wurde.
Der Tabelle Inkompatible Befehlszeilenoptionen können Sie entnehmen, welche Optionen zusammen verwendet werden können und welche Befehlszeilenoptionen inkompatibel sind.
Syntax
In diesem Abschnitt werden die Syntax und die Verwendung der Befehlszeilenoptionen beschrieben, die beim Ausführen des Befehls LoadState verfügbar sind. Die Optionen können in beliebiger Reihenfolge angegeben werden. Falls die Option einen Parameter enthält, können Sie einen Doppelpunkt oder ein Leerzeichen als Trennzeichen verwenden.
Die Syntax des Befehls LoadState lautet wie folgt:
loadstate StorePath [/i:[Path\]FileName] [/v:VerbosityLevel] [/nocompress] [/decrypt /key:KeyString|/keyfile:[Path\]FileName] [/l:[Path\]FileName] [/progress:[Path\]FileName] [/r:TimesToRetry] [/w:SecondsToWait] [/c] [/all] [/ui:[DomainName|ComputerName\]UserName] [/ue:[[DomainName|ComputerName\]UserName] [/uel:NumberOfDays|YYYY/MM/DD|0] [/md:OldDomain:NewDomain] [/mu:OldDomain\OldUserName:[NewDomain\]NewUserName] [/lac:[Password]] [/lae] [/config:[Path\]FileName] [/?|help]
Um den Speicher zu entschlüsseln und die Dateien und Einstellungen auf einem PC unter Windows Vista oder Windows 7 zu migrieren, geben Sie z. B. Folgendes in der Befehlszeile ein:
loadstate \\server\share\migration\mystore /i:migapp.xml /i:migdocs.xml /v:13 /decrypt /key:"mykey"
Speicheroptionen
USMT enthält die folgenden Optionen, mit denen Sie angeben können, wie und wo die migrierten Daten gespeichert werden.
Befehlszeilenoption | Beschreibung |
---|---|
StorePath |
Gibt den Ordner an, in dem die Dateien und Einstellungen gespeichert werden. Sie müssen StorePath bei der Verwendung des Befehls LoadState angeben. Es ist nicht möglich, mehrere Speicherorte mit StorePath anzugeben. |
/decrypt /key:KeyString oder /decrypt /key:"Key String" oder /decrypt /keyfile:[Path\]FileName |
Entschlüsselt den Speicher mit dem angegebenen Schlüssel. Bei dieser Option müssen Sie den Verschlüsselungsschlüssel mit einer der folgenden Methoden angeben:
KeyString darf nicht länger als 256 Zeichen sein. Die Optionen /key und /keyfile können nicht in derselben Befehlszeile verwendet werden. Die Optionen /decrypt und /nocompress können nicht in derselben Befehlszeile verwendet werden. > [!IMPORTANT] > Bei der Verwendung dieser Option ist Vorsicht angebracht, da jeder, der Zugriff auf das LoadState-Befehlszeilenskript hat, auch Zugriff auf den Verschlüsselungsschlüssel hat. >Beispiel:
|
/decrypt: "Verschlüsselungsstärke" |
Mit der Option /decrypt kann ein Befehlszeilenparameter zum Festlegen der Verschlüsselungsstärke für die Verschlüsselung des Migrationsspeichers angegeben werden. Weitere Informationen zu unterstützten Verschlüsselungsalgorithmen finden Sie unter Verschlüsselung des Migrationsspeichers. |
/hardlink |
Ermöglicht das Wiederherstellen von Benutzerstatusdaten aus einem Migrationsspeicher mit festem Link. Der Parameter /nocompress muss mit der Option /hardlink angegeben werden. |
/nocompress |
Gibt an, dass der Speicher nicht komprimiert wird. Diese Option sollte nur in Testumgebungen verwendet werden. Wir empfehlen, während der tatsächlichen Migration einen komprimierten Speicher zu verwenden. Diese Option kann nicht zusammen mit der Option /decrypt verwendet werden. Beispiel:
|
Migrationsregeloptionen
In USMT stehen die folgenden Optionen zum Angeben der zu migrierenden Dateien zur Verfügung.
Befehlszeilenoption | Beschreibung | |
---|---|---|
/i:[Path\]FileName |
(include) Gibt eine XML-Datei mit Regeln an, die den zu migrierenden Status festlegen. Sie können diese Option mehrmals angeben, um alle XML-Dateien („MigApp.xml“, „MigSys.xml“, „MigDocs.xml“ und von Ihnen erstellte benutzerdefinierte XML-Dateien) einzuschließen. Path kann ein relativer oder vollständiger Pfad sein. Wenn Sie die Path-Variable nicht angeben, muss sich FileName im aktuellen Verzeichnis befinden. Weitere Informationen zu den Dateien, die hier angegeben werden sollten, finden Sie im Abschnitt „XML-Dateien“ des Themas Häufig gestellte Fragen. |
|
/config:[Path\]FileName |
Gibt die Datei „Config.xml“ an, die vom Befehl LoadState verwendet werden soll. Diese Option kann in einer Befehlszeile nur einmal angegeben werden. Path kann ein relativer oder vollständiger Pfad sein. Wenn Sie die Path-Variable nicht angeben, muss sich FileName im aktuellen Verzeichnis befinden. In diesem Beispiel werden die Dateien und Einstellungen basierend auf den Regeln in den Dateien „Config.xml“, „MigDocs.xml“ und „MigApp.xml“ migriert:
|
|
/auto: "Pfad zu Skriptdateien" |
Diese Option ermöglicht es Ihnen, den Speicherort der XML-Standarddateien anzugeben und anschließend die Migration zu starten. Wird kein Pfad angegeben, verwendet USMT das Verzeichnis, in dem sich die USMT-Binärdateien befinden. Die Option /auto hat die gleiche Wirkung wie die Verwendung der folgenden Optionen: /i:MigDocs.xml/i:MigApp.xml /v:5. |
Überwachungsoptionen
USMT enthält mehrere Befehlszeilenoptionen, mit denen Sie während der Migration aufgetretene Probleme analysieren können.
Befehlszeilenoption | Beschreibung | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
/l:[Path\]FileName |
Gibt den Speicherort und Namen des LoadState-Protokolls an. Sie können keine Protokolldateien in StorePath speichern. Path kann ein relativer oder vollständiger Pfad sein. Wenn Sie die Path-Variable nicht angeben, wird das Protokoll im aktuellen Verzeichnis erstellt. Mit der Option /v können Sie den Umfang bzw. Ausführlichkeitsgrad der Protokollausgabe anpassen. Falls Sie den Befehl LoadState auf einer freigegebenen Netzwerkressource ausführen, müssen Sie diese Option angeben. Andernfalls schlägt die Ausführung von USMT mit dem folgenden Fehler fehl: „USMT was unable to create the log file(s)“. Um dieses Problem zu beheben, verwenden Sie die Option /l:load.log. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
/v: <VerbosityLevel> |
(Verbosity) Aktiviert die ausführliche Ausgabe in der LoadState-Protokolldatei. Der Standardwert ist "0". Sie können VerbosityLevel auf einen der folgenden Ausführlichkeitsgrade festlegen:
BenutzeroptionenStandardmäßig werden alle Benutzer migriert. Die einzige Möglichkeit zum Angeben der ein- und auszuschließenden Benutzer sind die folgenden Optionen. Es ist nicht möglich, Benutzer in den XML-Migrationsdateien oder mit der Datei „Config.xml“ auszuschließen. Weitere Informationen finden Sie unter Identifizieren von Benutzern.
Beispiele für die Optionen „/ui“ und „/ue“Die folgenden Beispiele gelten sowohl für die Option /ui als auch die Option /ue. Sie können /ue durch die Option /ui ersetzen, um die angegebenen Benutzer nicht auszuschließen, sondern einzuschließen.
Gemeinsame Verwendung der OptionenDie Optionen /uel, /ue und /ui können zusammen verwendet werden, um nur die gewünschten Benutzer zu migrieren. Die Option „/ui“ hat Vorrang vor den Optionen „/ue“ und „/uel“. Wenn ein Benutzer mit der Option /ui angegeben (eingeschlossen) und zudem mit der Option /ue oder /uel angegeben (ausgeschlossen) wird, wird er in die Migration einbezogen. Wenn Sie z. B. Die Option „/uel“ hat Vorrang vor der Option „/ue“. Wenn sich ein Benutzer innerhalb des mit /uel festgelegten Zeitraums angemeldet hat, wird das Profil dieses Benutzers auch dann migriert, wenn er mit der Option /ue ausgeschlossen wurde. Geben Sie z. B.
Inkompatible BefehlszeilenoptionenDie folgende Tabelle zeigt, welche Befehlszeilenoptionen nicht mit dem Befehl LoadState kompatibel sind. Falls der Tabelleneintrag für eine bestimmte Kombination leer ist, sind die Optionen kompatibel und können zusammen verwendet werden. Das Symbol X bedeutet, dass die Optionen nicht kompatibel sind. Die Option /nocompress kann z. B. nicht mit der Option /encrypt verwendet werden.
Hinweis Sie müssen die Option /key oder/keyfile mit der Option /encrypt angeben. Siehe auchWeitere Ressourcen |