Freigeben über

UsmtUtils-Syntax

  • Artikel

In diesem Thema wird die Syntax der Hilfsprogramme beschrieben, die in User State Migration Tool (USMT) 5.0 über die Befehlszeilenschnittstelle zur Verfügung stehen. Diese Hilfsprogramme:

  • Erleichtern das Ermitteln der Kryptografieoptionen für die Migration.

  • Unterstützen Sie beim Entfernen von Speichern mit festem Link, die aufgrund einer Freigabesperre nicht anders gelöscht werden können.

  • Überprüfen, ob die Katalogdatei oder andere Dateien im komprimierten Speicher beschädigt wurden.

  • Extrahieren Dateien aus dem komprimierten Migrationsspeicher, wenn Sie Dateien und Einstellungen zum Ziel-PC migrieren.

Inhalt dieses Themas

Usmtutils.exe

Verify-Optionen

Extract-Optionen

Usmtutils.exe

In der folgenden Tabelle sind die Befehlszeilenoptionen für „USMTutils.exe“ aufgeführt. In den folgenden Abschnitten werden weitere Befehlszeilenoptionen für die /verify- und /extract-Optionen erläutert.

Die Syntax für „UsmtUtils.exe“ lautet wie folgt:

usmtutils [/ec | /rd <storeDir> | /verify <filepath> [options] | /extract <filepath><destinationPath> [options]]

Befehlszeilenoption Beschreibung

/ec

Gibt eine Liste unterstützter Kryptografiealgorithmen (AlgIDs) im aktuellen System zurück. Mit dieser Liste können Sie auf einem Ziel-PC feststellen, welcher Algorithmus mit dem Befehl /encrypt verwendet werden muss, bevor Sie ScanState auf dem Quell-PC ausführen.

/rd <storeDir>

Entfernt den im <storeDir>-Argument angegebenen Verzeichnispfad auf dem PC. Sie können diesen Befehl verwenden, um Migrationsspeicher mit festem Link zu entfernen, die aufgrund einer Freigabesperre nicht an einer Eingabeaufforderung gelöscht werden können. Falls der Migrationsspeicher mehrere Volumes auf einem bestimmten Laufwerk umfasst, wird er aus allen Volumes gelöscht.

Beispiel:

usmtutils /rd D:\MyHardLinkStore

/y

Setzt die Eingabeaufforderung zum Bestätigen von Löschungen außer Kraft, wenn sie mit der Option /rd verwendet wird. Wenn Sie die Option /y mit der Option /rd verwenden, werden Sie zum Bestätigen der Löschungen aufgefordert, bevor USMT die Verzeichnisse löscht.

/verify

Gibt Informationen dazu zurück, ob der komprimierte Migrationsspeicher intakt ist oder ob er beschädigte Dateien oder einen beschädigten Katalog enthält.

Informationen zur Syntax und zu den Optionen, die mit Verify-OptionenVerify-Optionen/verify.

/extract

Stellt Dateien aus einem komprimierten USMT-Migrationsspeicher wieder her.

Informationen zur Syntax und zu den Optionen, die mit Extract-OptionenExtract-Optionen/extract.

Verify-Optionen

Verwenden Sie die Option /verify, wenn Sie überprüfen möchten, ob ein komprimierter Migrationsspeicher intakt ist oder ob er beschädigte Dateien oder einen beschädigten Katalog enthält. Weitere Informationen zur Verwendung der Option /verify finden Sie unter Überprüfen des Zustands eines komprimierten Migrationsspeichers.

Die Syntax für /verify lautet wie folgt:

usmtutils /verify[:<reportType>] <filePath> [/l:<logfile>] [/v:VerbosityLevel] [/decrypt [:<AlgID>] {/key:<keystring> | /keyfile:<filename>}]

Befehlszeilenoption Beschreibung

<reportType>

Gibt an, ob der Bericht alle Dateien, nur beschädigte Dateien oder den Status der Katalogdatei enthalten soll.

  • Summary. Gibt die Anzahl intakter Dateien und die Anzahl beschädigter Dateien im Migrationsspeicher zurück. Wird kein Algorithmus angegeben, wird standardmäßig der Zusammenfassungsbericht angezeigt.

  • all. Gibt eine durch Tabstopps getrennte Liste aller Dateien im komprimierten Migrationsspeicher und den Status jeder Datei zurück. Jede Zeile enthält einen Dateinamen gefolgt von einem Tapstopp und dem jeweiligen Status der Datei (CORRUPTED oder OK). Der letzte Eintrag gibt den Status des Katalogs (CATALOG) des Speichers an. Eine Katalogdatei enthält Metadaten für alle Dateien im Migrationsspeicher. LoadState benötigt eine gültige Katalogdatei, um den Migrationsspeicher zu öffnen. Gibt OK zurück, wenn die Katalogdatei intakt ist und LoadState den Migrationsspeicher öffnen kann, und CORRUPTED, wenn der Migrationsspeicher beschädigt ist.

  • failureonly. Gibt eine durch Tabstopps getrennte Liste der beschädigten Dateien im komprimierten Migrationsspeicher zurück.

  • Catalog. Gibt nur den Status der Katalogdatei zurück.

/l: <logfilePath>

Gibt den Speicherort und Namen der Protokolldatei an.

/v: <VerbosityLevel>

(Verbosity)

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

Sie können VerbosityLevel auf einen der folgenden Ausführlichkeitsgrade festlegen:

 

Grad Erlä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.

/decrypt: <AlgID> /key:<KeyString>

oder

/decrypt: <AlgID> /key:<“Key String”>

oder

/decrypt: <AlgID> /keyfile:<FileName>

Gibt an, dass die Option /encrypt verwendet wurde, um den Migrationsspeicher mit ScanState zu erstellen. Um den Migrationsspeicher zu entschlüsseln, geben Sie wie folgt die Option /key oder /keyfile an:

  • <AlgID> gibt den Kryptografiealgorithmus an, der zum Erstellen des Migrationsspeichers in der ScanState-Befehlszeile verwendet wurde. Wird kein Algorithmus angegeben, verwenden ScanState und UsmtUtils standardmäßig den 3DES-Algorithmus.

    Gültige Werte für <AlgID> sind: AES_128, AES_192, AES_256, 3DES oder 3DES_112.

  • /key: <KeyString> gibt den Verschlüsselungsschlüssel an. Falls <KeyString> ein Leerzeichen enthält, müssen Sie das Argument in Anführungszeichen einschließen.

  • /keyfile: <FileName> gibt den Speicherort und Namen einer Textdatei (.txt) an, die den Verschlüsselungsschlüssel enthält.

Weitere Informationen zu unterstützten Verschlüsselungsalgorithmen finden Sie unter Verschlüsselung des Migrationsspeichers.

Beispiele für /verify-Befehle:

  • usmtutils /verify D:\MyMigrationStore\store.mig

  • usmtutils /verify:catalog D:\MyMigrationStore\store.mig

  • usmtutils /verify:all D:\MyMigrationStore\store.mig /decrypt /l:D:\UsmtUtilsLog.txt

  • usmtutils /verify:failureonly D:\MyMigrationStore\store.mig /decrypt:AES_192 /keyfile:D:\encryptionKey.txt

Extract-Optionen

Verwenden Sie die Option /extract, um Dateien aus einem komprimierten USMT-Migrationsspeicher wiederherzustellen, wenn dieser sich nicht normal mit LoadState wiederherstellen lässt. Weitere Informationen zur Verwendung der Option /extract finden Sie unter Extrahieren von Dateien aus einem komprimierten USMT-Migrationsspeicher.

Die Syntax für /extract lautet wie folgt:

/extract <filePath><destinationPath> [/i:<includePattern>] [/e: <excludePattern>] [/l: <logfile>] [/v: VerbosityLevel>] [/decrypt[:<AlgID>] {key: <keystring> | /keyfile: <filename>}] [/o]

Befehlszeilenoption Beschreibung

<filePath>

Der Pfad zum USMT-Migrationsspeicher.

Beispiel:

D:\MyMigrationStore\USMT\store.mig

<destinationPath>

Der Pfad zu dem Ordner, in dem das Tool die einzelnen Dateien speichert.

/i:<includePattern>

Gibt ein Muster für Dateien an, die in die Extrahierung eingeschlossen werden sollen. Sie können mehrere Muster angeben. Trennen Sie Muster durch ein Komma oder ein Semikolon. Die Optionen /i: <includePattern> und /e: <excludePattern> können in demselben Befehl verwendet werden. Werden in der Befehlszeile sowohl Include- als auch Exclude-Muster angegeben, haben Include-Muster Vorrang von Exclude-Mustern.

/e:<excludePattern>

Gibt ein Muster für Dateien an, die von der Extrahierung ausgeschlossen werden sollen. Sie können mehrere Muster angeben. Trennen Sie Muster durch ein Komma oder ein Semikolon. Die Optionen /i: <includePattern> und /e: <excludePattern> können in demselben Befehl verwendet werden. Werden in der Befehlszeile sowohl Include- als auch Exclude-Muster angegeben, haben Include-Muster Vorrang von Exclude-Mustern.

/l:<logfilePath>

Gibt den Speicherort und Namen der Protokolldatei an.

/v: <VerbosityLevel>

(Verbosity)

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

Sie können VerbosityLevel auf einen der folgenden Ausführlichkeitsgrade festlegen:

 

Grad Erlä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.

/decrypt: <AlgID> /key:<KeyString>

oder

/decrypt: <AlgID> /key:<“Key String”>

oder

/decrypt: <AlgID> /keyfile:<FileName>

Gibt an, dass die Option /encrypt verwendet wurde, um den Migrationsspeicher mit ScanState zu erstellen. Um den Migrationsspeicher zu entschlüsseln, geben Sie wie folgt die Option /key oder /keyfile an:

  • <AlgID> gibt den Kryptografiealgorithmus an, der zum Erstellen des Migrationsspeichers in der ScanState-Befehlszeile verwendet wurde. Wird kein Algorithmus angegeben, verwenden ScanState und UsmtUtils standardmäßig den 3DES-Algorithmus.

    Gültige Werte für <AlgID> sind: AES_128, AES_192, AES_256, 3DES oder 3DES_112.

  • /key: <KeyString> gibt den Verschlüsselungsschlüssel an. Falls <KeyString> ein Leerzeichen enthält, müssen Sie das Argument in Anführungszeichen einschließen.

  • /keyfile:<FileName> gibt eine Textdatei (.txt) an, die den Verschlüsselungsschlüssel enthält.

Weitere Informationen zu unterstützten Verschlüsselungsalgorithmen finden Sie unter Verschlüsselung des Migrationsspeichers.

/o

Überschreibt vorhandene Ausgabedateien.

Beispiele für /extract-Befehle:

  • usmtutils /extract D:\MyMigrationStore\USMT\store.mig C:\ExtractedStore

  • usmtutils /extract D:\MyMigrationStore\USMT\store.mig /i:"*.txt, *.pdf" C:\ExtractedStore /decrypt /keyfile:D:\encryptionKey.txt

  • usmtutils /extract D:\MyMigrationStore\USMT\store.mig /e:*.exe C:\ExtractedStore /decrypt:AES_128 /key:password /l:C:\usmtlog.txt

  • usmtutils /extract D:\MyMigrationStore\USMT\store.mig /i:myProject.* /e:*.exe C:\ExtractedStore /o

Siehe auch

Weitere Ressourcen

USMT-Befehlszeilensyntax
Rückgabecodes