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

Синтаксис UsmtUtils

  • Статья

Назначение: Windows 7, Windows 8, Windows 8.1

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

  • дают вам больший контроль над параметрами шифрования при переносе;

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

  • проверяют, не был ли поврежден файл каталога или любые другие файлы в сжатом хранилище переноса;

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

В этом разделе

Usmtutils.exe

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

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

Usmtutils.exe

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

Синтаксис для UsmtUtils.exe следующий:

usmtutils [/ec | /rd <папкаХранилища> | /verify <путькФайлу> [параметры] | /extract <путькФайлу><конечныйПуть> [параметры]]

Параметр командной строки Описание

/ec

Возвращает список поддерживаемых алгоритмов шифрования в текущей системе. Вы можете использовать его на конечном компьютере, чтобы определить, какой алгоритм использовать для команды /encrypt, перед тем как запустить на исходном компьютере средство ScanState.

/rd <папкаХранилища>

Удаляет путь к каталогу, указанный аргументом <папкаХранилища> на компьютере. При помощи этой команды вы можете удалить хранилища переноса с жесткой связью, которые невозможно удалить из командной строки иначе по причине блокировки общего доступа. Если хранилище переноса охватывает несколько томов на данном диске, оно будет удалено из всех этих томов.

Например:

usmtutils /rd D:\MyHardLinkStore

/y

Переопределяет запрос на удаление при использовании с параметром /rd. При использовании параметра /y с параметром /rd вы не будете получать запрос на удаление перед тем, как Средство миграции пользовательской среды удалит папки.

/verify

Сообщает, не содержит ли сжатое хранилище переноса поврежденные файлы или поврежденный каталог.

Синтаксис и параметры для /verify см. в разделе Параметры проверки.

/extract

Восстанавливает файлы из сжатого хранилища переноса.

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

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

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

Для /verify используется следующий синтаксис:

usmtutils /verify[:<типОтчета>] <путькФайлу> [/l:<файлЖурнала>] [/v:УровеньПодробности] [/decrypt [:<АлгоритмШифрования>] {/key:<строкаКлюча> | /keyfile:<имяФайла>}]

Параметр командной строки Описание

<типОтчета>

Определяет, будут ли включены в отчет сведения обо всех файлах, только о поврежденных или о состоянии каталога.

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

  • all. Выдает список (разделитель – табуляция), где перечислены все файлы в сжатом хранилище переноса и описано состояние каждого файла. Каждая строка содержит имя файла, за ним следует шаг табуляции, а следом – значение CORRUPTED или OK, в зависимости от состояния файла. Последняя запись сообщает, не поврежден ли каталог (CATALOG) хранилища. Файл каталога содержит метаданные для всех файлов в хранилище переноса. Чтобы открыть хранилище переноса, средству LoadState необходим действительный файл каталога. Выдает значение OK, если файл каталога не поврежден, и LoadState может открыть хранилище переноса; или CORRUPTED, если хранилище переноса повреждено.

  • failureonly. Выдает список (разделитель – табуляция), где перечислены только поврежденные файлы, имеющиеся в сжатом хранилище переноса.

  • Catalog. Сообщает только о состоянии файла каталога.

/l: <файлЖурналаPath>

Указывает расположение и имя файла журнала.

/v: <УровеньПодробности>

(Verbosity)

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

Для параметра УровеньПодробности можно задать одно из следующих значений.

 

Уровень Объяснение

0

Включены только стандартные ошибки и предупреждения.

1

Включает режим подробного протоколирования.

4

Включает режим протоколирования отчетов об ошибках и состояниях.

5

Включает режим подробного протоколирования состояния.

8

Включает перенос отчета об ошибке в отладчик.

9

Включает перенос подробного отчета об ошибке в отладчик.

12

Включает перенос отчета об ошибке и состоянии в отладчик.

13

Включает режим подробного отчета, отчета о состоянии и отчета отладчика.

/decrypt: <АлгоритмШифрования> /key:<строкаКлюча>

Или:

/decrypt: <АлгоритмШифрования> /key:<"Строка ключа">

Или:

/decrypt: <АлгоритмШифрования> /keyfile:<имяФайла>

Указывает, что при создании хранилища переноса средством ScanState был использован параметр /encrypt. Для расшифровки хранилища переноса укажите параметр /key или /keyfile следующим образом:

  • <АлгоритмШифрования> определяет алгоритм шифрования, который использовался для создания хранилища переноса в командной строке ScanState. Если алгоритм не указан, ScanState и UsmtUtils по умолчанию используют алгоритм 3DES.

    Допустимые значения аргумента <АлгоритмШифрования>: AES_128, AES_192, AES_256, 3DES или 3DES_112.

  • /key: <строкаКлюча> указывает ключ шифрования. Если <строкаКлюча> содержит пробел, необходимо заключить аргумент в кавычки.

  • /keyfile: <имяФайла> указывает расположение и имя текстового файла (.txt), который содержит ключ шифрования.

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

Некоторые примеры команд /verify:

  • 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, чтобы восстановить файлы из сжатого хранилища переноса средства миграции пользовательской среды, если это не удастся выполнить при помощи loadstate. Дополнительные сведения об использовании параметра /extract см. в разделе Извлечение файлов из сжатого хранилища миграции средства миграции пользовательской среды.

Синтаксис для /extract следующий:

/extract <путькФайлу><конечныйПуть> [/i:<шаблонВключения>] [/e: <шаблонИсключения>] [/l: <файлЖурнала>] [/v: УровеньПодробности>] [/decrypt[:<АлгоритмШифрования>] {key: <строкаКлюча> | /keyfile: <имяФайла>}] [/o]

Параметр командной строки Описание

<путькФайлу>

Путь к хранилищу переноса.

Пример:

D:\MyMigrationStore\USMT\store.mig

<конечныйПуть>

Путь к папке, куда средство помещает отдельные файлы.

/i:<шаблонВключения>

Указывает шаблон включения файлов в извлечение. Можно указать несколько шаблонов. Разделяйте шаблоны запятой или точкой с запятой. Параметры /i: <шаблонВключения> и /e: <шаблонИсключения> можно использовать в одной команде. Если в командной строке используются шаблоны как для включения, так и для исключения файлов, преимущество имеют шаблоны включения.

/e:<шаблонИсключения>

Указывает шаблон исключения файлов из извлечения. Можно указать несколько шаблонов. Разделяйте шаблоны запятой или точкой с запятой. Параметры /i: <шаблонВключения> и /e: <шаблонИсключения> можно использовать в одной команде. Если в командной строке используются шаблоны как для включения, так и для исключения файлов, преимущество имеют шаблоны включения.

/l:<путькФайлуЖурнала>

Указывает расположение и имя файла журнала.

/v: <УровеньПодробности>

(Verbosity)

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

Для параметра УровеньПодробности можно задать одно из следующих значений.

 

Уровень Объяснение

0

Включены только стандартные ошибки и предупреждения.

1

Включает режим подробного протоколирования.

4

Включает режим протоколирования отчетов об ошибках и состояниях.

5

Включает режим подробного протоколирования состояния.

8

Включает перенос отчета об ошибке в отладчик.

9

Включает перенос подробного отчета об ошибке в отладчик.

12

Включает перенос отчета об ошибке и состоянии в отладчик.

13

Включает режим подробного отчета, отчета о состоянии и отчета отладчика.

/decrypt: <АлгоритмШифрования> /key:<строкаКлюча>

или

/decrypt: <АлгоритмШифрования> /key:<"Строка ключа">

или

/decrypt: <АлгоритмШифрования> /keyfile:<имяФайла>

Указывает, что при создании хранилища переноса средством ScanState был использован параметр /encrypt. Для расшифровки хранилища переноса укажите параметр /key или /keyfile следующим образом:

  • <АлгоритмШифрования> определяет алгоритм шифрования, который использовался для создания хранилища переноса в командной строке ScanState. Если алгоритм не указан, ScanState и UsmtUtils по умолчанию используют алгоритм 3DES.

    Допустимые значения аргумента <АлгоритмШифрования>: AES_128, AES_192, AES_256, 3DES или 3DES_112.

  • /key: <строкаКлюча> указывает ключ шифрования. Если <строкаКлюча> содержит пробел, необходимо заключить аргумент в кавычки.

  • /keyfile:<ИмяФайла> указывает расположение и имя текстового файла (.txt), который содержит ключ шифрования

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

/o

Перезаписывает существующие выходные файлы.

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

  • 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

См. также

Задачи

Коды возврата

Другие ресурсы

Синтаксис команд средства миграции пользовательской среды