LoadState-Syntax
In diesem Thema werden die Befehlssyntax und Optionen für LoadState behandelt.
Inhalt dieses Themas
Vorbereitung
Syntax
Speicheroptionen
Migrationsregeloptionen
Überwachungsoptionen
Benutzeroptionen
Inkompatible Befehlszeilenoptionen
Vorbereitung
Beachten Sie vor dem Ausführen von LoadState Folgendes:
Um sicherzustellen, dass alle Betriebssystemeinstellungen migriert werden, empfehlen wir die Ausführung von LoadState im Administratormodus in einem Konto mit Administratorrechten.
Weitere Informationen zu den Softwareanforderungen für die Ausführung von LoadState finden Sie unter USMT-Anforderungen.
Melden Sie sich nach der Ausführung von LoadState ab. 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 erfordert zur Anwendung von Domänenprofilen keinen Zugriff auf den Domänencontroller. Diese Funktion ist ohne zusätzliche Konfiguration verfügbar. Der Quellcomputer muss nicht über Zugriff auf den Domänencontroller verfügen, wenn das Benutzerprofil mit ScanState abgerufen wurde. Auf Domänenprofile kann aber erst zugegriffen werden, wenn der Zielcomputer der Domäne hinzugefügt wurde.
In der Tabelle Inkompatible Befehlszeilenoptionen ist aufgeführt, welche Optionen zusammen verwendet werden können und welche Befehlszeilenoptionen inkompatibel sind.
Syntax
In diesem Abschnitt werden die Syntax und die Verwendung der Befehlszeilenoptionen erläutert, die bei Verwendung von 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 für LoadState lautet folgendermaßen:
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]
Geben Sie zum Entschlüsseln des Speichers und Migrieren der Dateien und Einstellungen auf einem Computer mit Windows 7 beispielsweise Folgendes in die Befehlszeile ein:
loadstate \\server\share\migration\mystore /i:migapp.xml /i:migdocs.xml /v:13 /decrypt /key:"mykey"
Speicheroptionen
USMT bietet folgende Optionen zur Angabe, wie und wo die migrierten Daten gespeichert werden.
Befehlszeilenoption | Beschreibung |
---|---|
StorePath |
Gibt den Ordner an, in dem die Dateien und Einstellungen gespeichert werden. Geben Sie StorePath bei Verwendung von LoadState an. Sie können nicht mehr als einen StorePath angeben. |
/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 256 Zeichen nicht überschreiten. 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. WichtigVerwenden Sie diese Option mit Vorsicht, da jeder mit Zugriff auf das Befehlszeilenskript LoadState auch auf den Verschlüsselungsschlüssel zugreifen kann. Beispiel:
|
/decrypt:"encryption strength" |
Für die Option /decrypt kann ein Befehlszeilenparameter verwendet werden, um die Stärke der Verschlüsselung des Migrationsspeichers zu definieren. 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
USMT bietet die folgenden Optionen zum Angeben, welche Dateien migriert werden sollen.
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) einzubeziehen. Path kann ein relativer oder vollständiger Pfad sein. Wenn Sie die Variable Path angeben, muss sich FileName im aktuellen Verzeichnis befinden. Weitere Informationen zu den anzugebenden Dateien finden Sie im Thema Häufig gestellte Fragen im Abschnitt „XML-Dateien“. |
/config:[Path\]FileName |
Gibt die Config.xml-Datei an, die von 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 Variable Path angeben, muss sich der 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:"path to script files" |
Diese Option ermöglicht es Ihnen, den Speicherort der XML-Standarddateien anzugeben und anschließend die Migration zu starten. Wenn kein Pfad angegeben ist, verwendet USMT das Verzeichnis, in dem die USMT-Binärdateien gespeichert sind. Die Option /auto hat die gleiche Wirkung wie die Verwendung der folgenden Optionen: /i:MigDocs.xml /i:MigApp.xml /v:5. |
Überwachungsoptionen
USMT bietet 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. Die Protokolldateien können nicht unter StorePath gespeichert werden. Path kann ein relativer oder vollständiger Pfad sein. Wenn Sie die Variable Path nicht angeben, wird das Protokoll im aktuellen Verzeichnis erstellt. Sie können die Option /v angeben, um die Ausgabemenge anzupassen. Bei Ausführung von LoadState in einer freigegebenen Netzwerkressource müssen Sie diese Option angeben, oder USMT gibt folgende Fehlermeldung aus: „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 eine der folgenden Ebenen festlegen:
GradErläuterung
0 Aktiviert nur die standardmäßigen Fehler und Warnungen.
1 Aktiviert die ausführliche Ausgabe.
4 Aktiviert die Fehler- und Statusausgabe.
5 Aktiviert die ausführliche Ausgabe und 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 die ausführliche Ausgabe, Status- und Debuggerausgabe.
Beispiel:
|
/progress:[Path\]FileName |
Erstellt das optionale Statusprotokoll. Die Protokolldateien können nicht unter StorePath gespeichert werden. Path kann ein relativer oder vollständiger Pfad sein. Wenn Sie die Variable Path nicht angeben, wird FileName im aktuellen Verzeichnis erstellt. Beispiel:
|
/c |
Wenn diese Option angegeben wird, wird LoadState weiterhin ausgeführt, auch wenn kein schwerwiegender Fehler auftritt. Alle Dateien oder Einstellungen, die einen Fehler verursachen, werden im Statusprotokoll erfasst. Angenommen, für eine große Datei ist nicht ausreichend Speicherplatz auf dem Computer vorhanden. In diesem Fall protokolliert LoadState einen Fehler, und die Migration wird fortgesetzt. Ohne die Option /c wird LoadState beim ersten Fehler beendet. Sie können den neuen <ErrorControl>-Abschnitt in der Datei „Config.xml“ verwenden, um anzugeben, welche Datei- oder Registrierungs-bezogenen Lese-/Schreibfehler gefahrlos ignoriert werden können und welche zum Fehlschlagen der Migration führen könnten. Auf diese Weise können von der Befehlszeilenoption /c alle Eingabe-/Ausgabefehler (E/A) in der Umgebung sicher übersprungen werden. Darüber hinaus wird von der Option /genconfig nun ein <ErrorControl>-Bildpunktabschnitt erstellt, der durch die Angabe von Fehlermeldungen und gewünschter Verhalten in der Datei „Config.xml“ aktiviert wird. |
/r:<TimesToRetry> |
(Wiederholen) Gibt die Anzahl von Wiederholungen an, die ausgeführt wird, wenn beim Migrieren des Benutzerstatus von einem Server ein Fehler auftritt. Der Standardwert ist drei (Male). Diese Option eignet sich für Umgebungen mit unzuverlässiger Netzwerkkonnektivität. Beim Wiederherstellen des Benutzerstatus werden von der Option /r keine Daten wiederhergestellt, die aufgrund eines Fehlers der Netzwerkhardware, z. B. ein defektes oder getrenntes Netzwerkkabel, oder durch einen Fehler in der VPN-Verbindung verloren wurden. Die Wiederholungsoption kann für große Netzwerke mit regem Datenverkehr verwendet werden, bei denen die Konnektivität ausreichend ist, die Kommunikationslatenz aber ein Problem darstellt. |
/w:<SecondsBeforeRetry> |
(Warten) Gibt die Wartezeit in Sekunden an, bevor ein Netzwerkdateivorgang wiederholt wird. Der Standardwert ist 1 Sekunde. |
/? oder /help |
Zeigt die Hilfe in der Befehlszeile an. |
Benutzeroptionen
Standardmäß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.
Befehlszeilenoption | Beschreibung |
---|---|
/all |
Migriert alle Benutzer auf dem Computer. USMT migriert alle Benutzerkonten auf dem Computer, es sei denn, Sie schließen ein Konto mit der Option /ue oder /uel explizit aus. Aus diesem Grund müssen Sie diese Option nicht in der Befehlszeile angeben. Wenn Sie allerdings die Option /all verwenden möchten, können Sie auch die Optionen /ui, /ue oder /uel verwenden. |
/ui:DomainName\UserName oder /ui:"DomainName\User Name" oder /ui:ComputerName\LocalUserName |
(Benutzer einschließen) Migriert den angegebenen Benutzer. Standardmäßig werden alle Benutzer in die Migration einbezogen. Diese Option ist daher nur bei Verwendung der Option /ue hilfreich. Sie können mehrere /ui-Optionen angeben, allerdings kann die Option /ui nicht mit der Option /all verwendet werden. DomainName und UserName können den Sternchen-Platzhalter (*) enthalten. Wenn Sie einen Benutzernamen mit Leerzeichen angeben, müssen Sie ihn in Anführungszeichen einschließen. Beispiel:
Wenn ein Benutzer mit der Option /ui einbezogen und zugleich anhand der Optionen vom Typ /ue oder /uel ausgeschlossen wird, wird er in die Migration einbezogen. Weitere Beispiele finden Sie in den Beschreibung der Optionen /uel, /ue und /ui in dieser Tabelle. |
/uel:<NumberOfDays> oder /uel:<YYYY/MM/DD> oder /uel:0 |
(Benutzer basierend auf der letzten Anmeldung ausschließen) Migriert nur die Benutzer, die sich innerhalb des angegebenen Zeitraums am Quellcomputer angemeldet haben, basierend auf der Datumsangabe unter Zuletzt geändert der Datei „Ntuser.dat“ auf dem Quellcomputer. Die Option /uel fungiert als Include-Regel. Mit der Option /uel:30 werden ausschließlich Benutzer migriert, die sich innerhalb der letzten 30 Tage ab dem Datum, an dem ScanState ausgeführt wurde, angemeldet haben oder deren Benutzerkonto innerhalb dieses Zeitraums geändert wurde. Sie können eine Anzahl von Tagen oder ein Datum angeben. Sie können diese Option nicht mit der Option /all verwenden. USMT ruft die Informationen zur letzten Anmeldung vom lokalen Computer ab, damit der Computer nicht mit dem Netzwerk verbunden sein muss, wenn die Option ausgeführt wird. Zudem wird diese Anmeldeinstanz nicht vom USMT berücksichtigt, wenn sich ein Domänenbenutzer an einem anderen PC angemeldet hat. HinweisDie Option /uel ist in Offlinemigrationen nicht gültig. Beispiele:
Beispiel:
|
/ue:DomainName\UserName oder /ue:"DomainName\User Name" oder /ue:ComputerName\LocalUserName |
(Benutzer ausschließen) Schließt die angegebenen Benutzer von der Migration aus. Sie können mehrere /ue-Optionen angeben, allerdings kann die Option /ue nicht mit der Option /all verwendet werden. DomainName und UserName können den Sternchen-Platzhalter (*) enthalten. Wenn Sie einen Benutzernamen mit Leerzeichen angeben, müssen Sie ihn in Anführungszeichen einschließen. Beispiel:
Weitere Beispiele finden Sie in den Beschreibung der Optionen /uel, /ue und /ui in dieser Tabelle. |
/md:OldDomain:NewDomain oder /md:LocalComputerName:NewDomain |
(Domäne verschieben) Gibt eine neue Domäne für den Benutzer an. Verwenden Sie diese Option, um die Domäne für Benutzer auf einem PC zu ändern oder einen lokalen Benutzer zu einem Domänenkonto zu migrieren. OldDomain kann ein Sternchen (*) als Platzhalterzeichen enthalten. Diese Option kann mehrmals angegeben werden. Wenn Sie Benutzer aus mehreren Domänen in einer Domäne konsolidieren, bietet sich die Angabe mehrerer /md-Optionen an. Geben Sie z. B. Folgendes ein, um die Benutzer aus den Corporate- und FarNorth-Domänen in der Fabrikam-Domäne zu konsolidieren: Falls Konflikte zwischen zwei /md-Befehlen auftreten, wird die erste angegebene Regel angewendet. Wenn Sie z. B. die Befehle Wenn Sie eine OldDomain angeben, die nicht auf dem Quellcomputer vorhanden ist, wird LoadState scheinbar erfolgreich ohne Fehler- oder Warnmeldung abgeschlossen. Allerdings werden in diesem Fall die Benutzer nicht nach NewDomain verschoben sondern verbleiben in der ursprünglichen Domäne. Falls Sie z. B. „contoso“ falsch schreiben und „/md:contso:fabrikam“ eingeben, verbleiben die Benutzer auf dem Zielcomputer in der Contoso-Domäne. Beispiel:
|
/mu:OldDomain\OldUserName:[NewDomain\]NewUserName oder /mu:OldLocalUserName:NewDomain\NewUserName |
Gibt einen neuen Benutzernamen für den angegebenen Benutzer an. Wenn der Speicher mehrere Benutzer enthält, können Sie mehrere /mu-Optionen angeben. Bei dieser Option können keine Platzhalterzeichen verwendet werden. Beispiel:
|
/lac:[Password] |
(Lokales Konto erstellen) Gibt an, dass USMT das Konto auf dem Zielcomputer zwar erstellt, dieses aber deaktiviert wird, wenn es sich bei einem Benutzerkonto um ein lokales Konto (nicht in einer Domäne enthalten) handelt und dieses auf dem Zielcomputer nicht vorhanden ist. Um das Konto zu aktivieren, müssen Sie ebenfalls die Option /lae verwenden. Wenn die Option /lac nicht angegeben wird, werden lokale Benutzerkonten, die nicht bereits auf dem Zielcomputer vorhanden sind, nicht migriert. Password ist das Kennwort für das neu erstellte Konto. Standardmäßig wird ein leeres Kennwort verwendet. AchtungVerwenden Sie die Password-Variable mit Vorsicht, da sie in Nur-Text angegeben wird und von jedem Benutzer mit Zugriff auf den Computer, auf dem LoadState ausgeführt wird, abgerufen werden kann. Wenn auf dem PC mehrere Benutzer vorhanden sind, haben außerdem alle migrierten Benutzer dasselbe Kennwort. Beispiel:
Eine Anleitung hierzu finden Sie unter Migrieren von Benutzerkonten. |
/lae |
(Lokales Konto aktivieren) Aktiviert das Konto, das mit der Option /lac erstellt wurde. Sie müssen die Option /lac mit dieser Option angeben. Beispiel:
Eine Anleitung hierzu finden Sie unter Migrieren von Benutzerkonten. |
Beispiele für die Optionen „/ui“ und „/ue“
Die folgenden Beispiele gelten für die Optionen /ui und /ue. Ersetzen Sie die Option /ue durch die Option /ui, um die angegebenen Benutzer nicht auszuschließen sondern einzubeziehen.
Verhalten | Befehl |
---|---|
Den Benutzer „User One“ in der Corporate-Domäne ausschließen. |
|
Den Benutzer „User1“ in der Corporate-Domäne ausschließen. |
|
Den lokalen Benutzer „User1“ ausschließen. |
|
Alle Domänenbenutzer ausschließen. |
|
Alle lokalen Benutzer ausschließen. |
|
Benutzer namens „User1“, „User2“ usw. in allen Domänen ausschließen. |
|
Gemeinsame Verwendung der Optionen
Sie können die Optionen /uel, /ue und /ui zusammen verwenden, 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 einbezogen und gleichzeitig entweder mit der Option /ue oder /uel ausgeschlossen wird, wird er in die Migration einbezogen. Wenn Sie beispielsweise /ui:contoso\* /ue:contoso\user1
angeben, wird User1 migriert, da die Option /ui gegenüber /ue vorrangig behandelt wird.
Die Option „/uel“ hat Vorrang vor der Option „/ue“. Wenn sich ein Benutzer innerhalb des festgelegten Zeitraums angemeldet hat, der mit der Option /uel festgelegt wurde, wird das Profil des Benutzers auch dann migriert, wenn er mit der Option /ue ausgeschlossen wurde. Geben Sie z. B. /ue:contoso\user1 /uel:14
an, wird User1 migriert, sofern er sich innerhalb der letzten 14 Tage am PC angemeldet hat.
Verhalten | Befehl |
---|---|
Nur User2 aus der Fabrikam-Domäne einbeziehen und alle anderen Benutzer ausschließen. |
|
Nur den lokalen Benutzer User1 einbeziehen und alle anderen Benutzer ausschließen. |
|
Nur die Domänenbenutzer aus der Contoso-Domäne mit Ausnahme von „Contoso\User1“ einbeziehen. |
Dieses Verhalten kann nicht mit einem einzigen Befehl herbeigeführt werden. Stattdessen müssen Sie Folgendes angeben, um diesen Satz von Benutzern zu migrieren:
|
Nur lokale (nicht in einer Domäne enthaltene) Benutzer einschließen. |
|
Inkompatible Befehlszeilenoptionen
Die folgende Tabelle zeigt, welche Befehlszeilenoptionen nicht mit 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. Beispielsweise kann die Option /nocompress nicht mit der Option /encrypt verwendet werden.
Befehlszeilenoption | /keyfile | /nocompress | /genconfig | /all |
---|---|---|---|---|
/i |
||||
/v |
||||
/nocompress |
Nicht verfügbar |
X |
||
/key |
X |
X |
||
/decrypt |
Erforderlich* |
X |
X |
|
/keyfile |
Nicht verfügbar |
X |
||
/l |
||||
/progress |
X |
|||
/r |
X |
|||
/w |
X |
|||
/c |
X |
|||
/p |
X |
Nicht verfügbar |
||
/all |
X |
|||
/ui |
X |
X |
||
/ue |
X |
X |
||
/uel |
X |
X |
||
/genconfig |
Nicht verfügbar |
|||
/config |
X |
|||
StorePath |
||||
/md |
||||
/mu |
||||
/lae |
||||
/lac |
Hinweis
Sie müssen entweder die Option /key oder /keyfile mit der Option / encrypt angeben.