Поделиться через

Синтаксис UsmtUtils

  • Статья
  • Применяется к:
    ✅ Windows 11, ✅ Windows 10

В этой статье описывается синтаксис служебных программ, доступных в средстве миграции пользовательской среды (USMT) через интерфейс командной строки. Эти служебные программы:

  • Улучшение возможности определения параметров шифрования для миграции.

  • Помощь в удалении хранилищ с жесткой связью, которые в противном случае не могут быть удалены из-за блокировки общего доступа.

  • Проверьте, поврежден ли файл каталога или любой другой файл в сжатом хранилище миграции.

  • Извлеките файлы из сжатого хранилища миграции, созданного при переносе файлов и параметров на конечный компьютер.

UsmtUtils.exe

В следующей таблице перечислены параметры командной строки для UsmtUtils.exe. В следующих разделах содержатся дополнительные параметры командной /verify строки для параметров и /extract .

Синтаксис для UsmtUtils.exe :

UsmtUtils.exe [/ec | /rd <storeDir> | /verify <filepath> [options] | /extract <filepath><destinationPath> [параметры]]

Параметр командной строки Описание
/Европейское сообщество Возвращает список поддерживаемых алгоритмов шифрования (AlgID) в текущей системе. Этот параметр можно использовать на конечном компьютере, чтобы определить, какой алгоритм следует использовать с командой /encrypt перед запуском средства ScanState на исходном компьютере.
/rd<storeDir> Удаляет путь к каталогу, указанный аргументом <storeDir> на компьютере. Эту команду можно использовать для удаления хранилищ миграции с жесткой компоновкой, которые не могут быть удалены в командной строке из-за блокировки общего доступа. Если хранилище миграции охватывает несколько томов на заданном диске, хранилище миграции удаляется из всех этих томов.

Пример:
UsmtUtils.exe /rd D:\MyHardLinkStore
/y Переопределяет запрос на принятие удалений при использовании с параметром /rd . /y Если параметр используется вместе с параметром/rd, не отображается запрос на принятие удалений, прежде чем USMT удалит каталоги.
/проверять Возвращает сведения о том, является ли сжатое хранилище миграции нетронутым или содержит поврежденные файлы или поврежденный каталог.

См . раздел Проверка параметров синтаксиса и параметров для использования с /verify.
/экстракт Восстанавливает файлы из сжатого хранилища миграции USMT.

См . раздел Извлечение параметров для синтаксиса и параметров для использования с /extract.

Параметры проверки

Используйте параметр , /verify чтобы определить, является ли сжатое хранилище миграции нетронутым или содержит ли оно поврежденные файлы или поврежденный каталог. Дополнительные сведения об использовании параметра см. в /verify разделе Проверка состояния сжатого хранилища миграции.

Синтаксис для /verify :

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

Параметр командной строки Описание
<reportType> Указывает, следует ли сообщать обо всех файлах, только поврежденных файлах или о состоянии каталога.
  • Сводка. Возвращает как количество нетронутых файлов, так и количество поврежденных файлов в хранилище миграции. Если алгоритм не указан, сводный отчет отображается по умолчанию.
  • все. Возвращает список всех файлов в сжатом хранилище миграции с разделителями табуляции и состояние каждого файла. Каждая строка содержит имя файла, за которым следует интервал между вкладками, и в зависимости от состояния файла либо ПОВРЕЖДЕНо , либо ОК . Последняя запись сообщает о состоянии повреждения КАТАЛОГА хранилища. Файл каталога содержит метаданные для всех файлов в хранилище миграции. Чтобы открыть хранилище миграции, инструменту LoadState требуется допустимый файл каталога. Возвращает значение "ОК", если файл каталога нетронут и LoadState может открыть хранилище миграции и "ПОВРЕЖДЕНо", если хранилище миграции повреждено.
  • только сбой. Возвращает список только файлов, поврежденных в сжатом хранилище миграции с разделителями табуляции.
  • Каталог. Возвращает только состояние файла каталога.
/l:
<logfilePath>		 Указывает расположение и имя файла журнала.
/v:<VerbosityLevel> (Детализация)

Включает подробные выходные данные в файле журнала UsmtUtils . Значение по умолчанию — 0.

Для verbosityLevel можно задать один из следующих уровней:
  • 0 — включены только ошибки и предупреждения по умолчанию.
  • 1 — включает подробные выходные данные.
  • 4 . Включает вывод ошибок и состояния.
  • 5 . Включает подробные выходные данные и выходные данные состояния.
  • 8 . Включает вывод ошибок в отладчик.
  • 9 . Включает подробные выходные данные в отладчик.
  • 12 . Включает вывод ошибок и состояния в отладчик.
  • 13 . Включает подробные, состояние и выходные данные отладчика.
/decrypt<AlgID>/:<KeyString>
или
/decrypt<AlgID>/:<"Key String">
или
/decrypt:<AlgID>/keyfile:<FileName>		 Указывает, что /encrypt параметр использовался для создания хранилища миграции с помощью средства ScanState . Чтобы расшифровать хранилище миграции, укажите /key параметр или /keyfile следующим образом:
  • <AlgID> указывает криптографический алгоритм, который использовался для создания хранилища миграции в командной строке ScanState.exe . Если алгоритм не указан, ScanState и UsmtUtils используют алгоритм 3DES по умолчанию.
    <Допустимые значения AlgID> : AES_128, AES_192, AES_256, 3DESили 3DES_112.
  • /key: <KeyString> указывает ключ шифрования. Если в <KeyString> есть пробел, аргумент должен быть заключен в кавычки.
  • /keyfile: <FileName> указывает расположение и имя текстового (.txt) файла, содержащего ключ шифрования.

Дополнительные сведения о поддерживаемых алгоритмах шифрования см. в разделе Шифрование хранилища миграции.

Примеры /verify команд:

  • 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

Параметры извлечения

/extract Используйте параметр для восстановления файлов из сжатого хранилища миграции USMT, если оно не восстанавливается нормально с помощью LoadState. Дополнительные сведения об использовании параметра см. в /extract разделе Извлечение файлов из сжатого хранилища миграции USMT.

Синтаксис для /extract :

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

Параметр командной строки Описание
<filePath> Путь к хранилищу миграции USMT.

Пример:
D:\MyMigrationStore\USMT\store.mig
<destinationPath> Путь к папке, в которой средство помещает отдельные файлы.
/i:<includePattern> Задает шаблон для файлов, которые будут включены в извлечение. Можно указать несколько шаблонов. Разделяйте узоры запятой или точкой с запятой. Параметры /i: <includePattern> и /e: <excludePattern> можно использовать в одной команде. Если в командной строке используются шаблоны включения и исключения, шаблоны включения имеют приоритет над шаблонами исключения.
/e:<excludePattern> Указывает шаблон для файлов, которые следует исключить из извлечения. Можно указать несколько шаблонов. Разделяйте узоры запятой или точкой с запятой. Параметры /i: <includePattern> и /e: <excludePattern> можно использовать в одной команде. Если в командной строке используются шаблоны включения и исключения, шаблоны включения имеют приоритет над шаблонами исключения.
/l:<logfilePath> Указывает расположение и имя файла журнала.
/v:<VerbosityLevel> (Детализация)

Включает подробные выходные данные в файле журнала UsmtUtils . Значение по умолчанию — 0.

Для verbosityLevel можно задать один из следующих уровней:
  • 0 — включены только ошибки и предупреждения по умолчанию.
  • 1 — включает подробные выходные данные.
  • 4 . Включает вывод ошибок и состояния.
  • 5 . Включает подробные выходные данные и выходные данные состояния.
  • 8 . Включает вывод ошибок в отладчик.
  • 9 . Включает подробные выходные данные в отладчик.
  • 12 . Включает вывод ошибок и состояния в отладчик.
  • 13 . Включает подробные, состояние и выходные данные отладчика.
/decrypt*<AlgID>/key:<KeyString>
или
/расшифровать<AlgID>/:<"Key String">
или
/расшифровать:<AlgID>/keyfile:<FileName>*		 Указывает, что /encrypt параметр использовался для создания хранилища миграции с помощью средства ScanState . Чтобы расшифровать хранилище миграции /key , также необходимо указать параметр или /keyfile следующим образом:
  • <AlgID> указывает криптографический алгоритм, который использовался для создания хранилища миграции в командной строке ScanState.exe . Если алгоритм не указан, ScanState и UsmtUtils используют алгоритм 3DES по умолчанию.
    <Допустимые значения AlgID> : AES_128, AES_192, AES_256, 3DESили 3DES_112.
  • /key: <KeyString> указывает ключ шифрования. Если в <KeyString> есть пробел, аргумент должен быть заключен в кавычки.
  • /keyfile:<FileName> указывает текстовый (.txt) файл, содержащий ключ шифрования.

Дополнительные сведения о поддерживаемых алгоритмах шифрования см. в разделе Шифрование хранилища миграции.
/o Перезаписывает существующие выходные файлы.

Примеры /extract команд:

  • 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