Синтаксис UsmtUtils

  • Статья

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

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

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

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

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

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

Usmtutils.exe

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

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

Usmtutils.exe

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

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

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

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

/ec

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

/rd<storeDir>

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

Пример:

usmtutils /rd D:\MyHardLinkStore

/y

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

/verify

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

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

/extract

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

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

 

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

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

Синтаксис /verify:

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

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

<reportType>

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

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

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

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

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

<logfilePath>

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

/v:<VerbosityLevel>

(Verbosity)

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

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

УровеньОбъяснение
0 Включены только стандартные ошибки и предупреждения.
1 Включает режим подробного отчета.
4 Включает режим отчета об ошибках и состоянии.
5 Включает режим подробного отчета и отчета о состоянии.
8 Включает вывод отчета об ошибках в отладчик.
9 Включает вывод подробного отчета в отладчик.
12 Включает вывод отчета об ошибках и состоянии в отладчик.
13 Включает режим подробного отчета, отчета о состоянии и отчета для отладчика.

 

/decrypt<AlgID>/:<KeyString>

или

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

или

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

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

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

    Допустимые значения <AlgID>: AES_128, AES_192, AES_256, 3DES или 3DES_112.

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

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

Синтаксис /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>

(Verbosity)

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

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

УровеньОбъяснение
0 Включены только стандартные ошибки и предупреждения.
1 Включает режим подробного отчета.
4 Включает режим отчета об ошибках и состоянии.
5 Включает режим подробного отчета и отчета о состоянии.
8 Включает вывод отчета об ошибках в отладчик.
9 Включает вывод подробного отчета в отладчик.
12 Включает вывод отчета об ошибках и состоянии в отладчик.
13 Включает режим подробного отчета, отчета о состоянии и отчета для отладчика.

 

/decrypt<AlgID>/key:<KeyString>

или

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

или

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

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

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

    Допустимые значения <AlgID>: AES_128, AES_192, AES_256, 3DES или 3DES_112.

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

  • /keyfile:<FileName> указывает текстовый (.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

Связанные разделы

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

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