UsmtUtils-Syntax

In diesem Artikel wird die Syntax für die Hilfsprogramme beschrieben, die im User State Migration Tool (USMT) über die Befehlszeilenschnittstelle verfügbar sind. Diese Hilfsprogramme:

  • Verbessern sie die Möglichkeit, kryptografische Optionen für die Migration zu bestimmen.

  • Helfen Sie beim Entfernen von Speicher mit festem Link, die aufgrund einer Freigabesperre andernfalls nicht gelöscht werden können.

  • Überprüfen Sie, ob die Katalogdatei oder eine der anderen Dateien im komprimierten Migrationsspeicher beschädigt sind.

  • Extrahieren Sie Dateien aus dem komprimierten Migrationsspeicher, der erstellt wird, wenn Dateien und Einstellungen auf den Zielcomputer migriert werden.

UsmtUtils.exe

In der folgenden Tabelle sind Befehlszeilenoptionen für UsmtUtils.exeaufgeführt. Die folgenden Abschnitte enthalten weitere Befehlszeilenoptionen für die /verify Optionen und /extract .

Die Syntax für UsmtUtils.exe lautet:

UsmtUtils.exe [/ec | /rd <storeDir> | /verify <filepath> [options] | /extract <filepath><destinationPath> [options]]

Befehlszeilenoption Beschreibung
/EG Gibt eine Liste der unterstützten Kryptografiealgorithmen (AlgIDs) auf dem aktuellen System zurück. Diese Option kann auf einem Zielcomputer verwendet werden, um zu bestimmen, welcher Algorithmus mit dem /encrypt Befehl verwendet werden soll, bevor das ScanState-Tool auf dem Quellcomputer ausgeführt wird.
/rd<storeDir> Entfernt den verzeichnispfad, der durch das <argument storeDir> auf dem Computer angegeben wird. Dieser Befehl kann verwendet werden, um Festverknüpfungsspeicher zu löschen, die aufgrund einer Freigabesperre andernfalls nicht an einer Eingabeaufforderung gelöscht werden können. Wenn der Migrationsspeicher mehrere Volumes auf einem bestimmten Laufwerk umfasst, wird der Migrationsspeicher von allen diesen Volumes gelöscht.

Zum Beispiel:
UsmtUtils.exe /rd D:\MyHardLinkStore
/y Überschreibt die Eingabeaufforderung zum Akzeptieren von Löschungen, wenn sie mit der /rd Option verwendet wird. Wenn die /y Option mit der /rd Option verwendet wird, wird keine Eingabeaufforderung angezeigt, um die Löschungen zu akzeptieren, bevor USMT die Verzeichnisse löscht.
/überprüfen Gibt Informationen darüber zurück, ob der komprimierte Migrationsspeicher intakt ist oder beschädigte Dateien oder einen beschädigten Katalog enthält.

Informationen zur Syntax und optionen für die Verwendung mit /verifyfinden Sie unter Überprüfen von Optionen.
/Auszug Stellt Dateien aus einem komprimierten USMT-Migrationsspeicher wieder her.

Informationen zur Syntax und optionen für die Verwendung mit /extractfinden Sie unter Extrahieren von Optionen.

Überprüfen von Optionen

Verwenden Sie die /verify Option, um zu ermitteln, ob ein komprimierter Migrationsspeicher intakt ist oder beschädigte Dateien oder einen beschädigten Katalog enthält. Weitere Informationen zur Verwendung der /verify Option finden Sie unter Überprüfen der Bedingung eines komprimierten Migrationsspeichers.

Die Syntax für /verify lautet:

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

Befehlszeilenoption Beschreibung
<reportType> Gibt an, ob alle Dateien, nur beschädigte Dateien oder der Status des Katalogs gemeldet werden sollen.
  • Zusammenfassung. Gibt sowohl die Anzahl der intakten Dateien als auch die Anzahl der dateien zurück, die im Migrationsspeicher beschädigt sind. Wenn kein Algorithmus angegeben ist, wird der Zusammenfassungsbericht als Standard angezeigt.
  • alle. Gibt eine tabstopptrennte Liste aller Dateien im komprimierten Migrationsspeicher und den Status für jede Datei zurück. Jede Zeile enthält den Dateinamen, gefolgt von einem Tabstopp und je nach Status der Datei entweder BESCHÄDIGT oder OK . Der letzte Eintrag meldet den Beschädigungsstatus des KATALOGs des Speichers. Eine Katalogdatei enthält Metadaten für alle Dateien in einem Migrationsspeicher. Das Tool LoadState erfordert 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.
  • fehleronly. Gibt eine tabstopptrennte Liste nur der Dateien zurück, die im komprimierten Migrationsspeicher beschädigt sind.
  • Katalog. Gibt nur den Status der Katalogdatei zurück.
/l:
<logfilePath>		 Gibt den Speicherort und den Namen der Protokolldatei an.
/v:<VerbosityLevel> (Ausführlichkeit)

Aktiviert die ausführliche Ausgabe in der UsmtUtils-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.
/decrypt<AlgID>/:<KeyString>
or
/decrypt<AlgID>/:<"Key String">
or
/decrypt:<AlgID>/keyfile:<FileName>		 Gibt an, dass die /encrypt Option verwendet wurde, um den Migrationsspeicher mit dem ScanState-Tool zu erstellen. Geben Sie zum Entschlüsseln des Migrationsspeichers eine - oder /keyfile -/keyOption wie folgt an:
  • <AlgID> gibt den Kryptografiealgorithmus an, der zum Erstellen des Migrationsspeichers in der ScanState.exe Befehlszeile verwendet wurde. Wenn kein Algorithmus angegeben ist, verwenden ScanState und UsmtUtils den 3DES-Algorithmus als Standard.
    <Gültige AlgID-Werte> sind: AES_128, AES_192, AES_256, 3DESoder 3DES_112.
  • /key: <KeyString> gibt den Verschlüsselungsschlüssel an. Wenn in <KeyString> ein Leerzeichen vorhanden ist, muss das Argument in Anführungszeichen eingeschlossen werden.
  • /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 Migrationsspeicherverschlüsselung.

Einige Beispiele für /verify Befehle:

  • UsmtUtils.exe /verify D:\MyMigrationStore\store.mig

  • UsmtUtils.exe /verify:catalog D:\MyMigrationStore\store.mig

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

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

Extrahieren von Optionen

Verwenden Sie die /extract Option zum Wiederherstellen von Dateien aus einem komprimierten USMT-Migrationsspeicher, wenn er nicht normal mit LoadState wiederhergestellt wird. Weitere Informationen zur Verwendung der /extract Option finden Sie unter Extrahieren von Dateien aus einem komprimierten USMT-Migrationsspeicher.

Die Syntax für /extract lautet:

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

Befehlszeilenoption Beschreibung
<filePath> Pfad zum USMT-Migrationsspeicher.

Zum Beispiel:
D:\MyMigrationStore\USMT\store.mig
<destinationPath> Pfad zu dem Ordner, in dem das Tool die einzelnen Dateien ablegt.
/i:<includePattern> Gibt ein Muster für Dateien an, die in die Extraktion eingeschlossen werden sollen. Es können mehrere Muster angegeben werden. Trennen Sie Muster durch ein Komma oder semikolon. Die /iOptionen : <includePattern> und /e: <excludePattern> können im gleichen Befehl verwendet werden. Wenn sowohl Include- als auch Ausschlussmuster in der Befehlszeile verwendet werden, haben Includemuster Vorrang vor Ausschlussmustern.
/e:<excludePattern> Gibt ein Muster für Dateien an, die bei der Extraktion weggelassen werden sollen. Es können mehrere Muster angegeben werden. Trennen Sie Muster durch ein Komma oder semikolon. Die /iOptionen : <includePattern> und /e: <excludePattern> können im gleichen Befehl verwendet werden. Wenn sowohl Include- als auch Ausschlussmuster in der Befehlszeile verwendet werden, haben Includemuster Vorrang vor Ausschlussmustern.
/l:<logfilePath> Gibt den Speicherort und den Namen der Protokolldatei an.
/v:<VerbosityLevel> (Ausführlichkeit)

Aktiviert die ausführliche Ausgabe in der UsmtUtils-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.
/decrypt*<AlgID>/key:<KeyString>
or
/entschlüsseln<AlgID>/:<"Key String">
or
/entschlüsseln:<AlgID>/keyfile:<FileName>*		 Gibt an, dass die /encrypt Option verwendet wurde, um den Migrationsspeicher mit dem ScanState-Tool zu erstellen. Zum Entschlüsseln des Migrationsspeichers muss auch die /key Option oder /keyfile wie folgt angegeben werden:
  • <AlgID> gibt den Kryptografiealgorithmus an, der zum Erstellen des Migrationsspeichers in der ScanState.exe Befehlszeile verwendet wurde. Wenn kein Algorithmus angegeben ist, verwenden ScanState und UsmtUtils den 3DES-Algorithmus als Standard.
    <Gültige AlgID-Werte> sind: AES_128, AES_192, AES_256, 3DESoder 3DES_112.
  • /key: <KeyString> gibt den Verschlüsselungsschlüssel an. Wenn in <KeyString> ein Leerzeichen vorhanden ist, muss das Argument in Anführungszeichen eingeschlossen werden.
  • /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.

Einige Beispiele für /extract Befehle:

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

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

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

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