UsmtUtils 语法
本主题描述通过命令行接口在 用户状态迁移工具 (USMT) 5.0 中可用的实用工具的语法。这些实用工具：
提高你为迁移确定加密选项的能力。
协助移除由于共享锁定无法以其他方式删除的硬链接存储。
验证目录文件或压缩迁移存储中的任何其他文件是否已损坏。
当你将文件和设置迁移至目标计算机时，从压缩的迁移存储中解压缩文件。
本主题内容
Usmtutils.exe
验证选项
解压缩选项
Usmtutils.exe
下表列出 USMTutils.exe 的命令行选项。以下部分提供适用于 /verify 的其他命令行选项以及 /extract 选项。
UsmtUtils.exe 的语法：
usmtutils [/ec | /rd <storeDir> | /verify <filepath> [options] | /extract <filepath><destinationPath> [options]]
| 命令行选项 | 描述 |
|---|---|
/ec |
返回当前系统上获支持的加密算法 (AlgID) 列表。你可使用目标计算机上的该加密算法，确定在运行源计算机上的 ScanState 工具前，对 /encrypt 命令使用哪种算法。 |
/rd <storeDir> |
删除通过计算机上的 <storeDir> 参数指定的目录路径。你可以使用此命令删除因共享锁定而无法在命令提示符下删除的硬链接迁移存储。如果迁移存储跨越指定驱动器上的多个卷，则从所有这些卷中将它删除。 例如：
|
/y |
当使用 /rd 选项时，覆盖接受删除内容提示符。当你同时使用 /y 选项和 /rd 选项时，则在 USMT 删除目录之前，你将收不到提醒你接受删除内容的提示。 |
/verify |
返回有关压缩的迁移存储是否完整或它含有的文件或目录是否已损坏的信息。 有关与 /verify 同时使用的选项和语法的详细信息，请参阅验证选项。 |
/extract |
从压缩的 USMT 迁移存储中恢复文件。 有关与 /extract 同时使用的选项和语法的详细信息，请参阅解压缩选项。 |
验证选项
当你想确定压缩的迁移存储是否完整或它含有的文件或目录是否已损坏时，使用 /verify 选项。有关如何使用 /verify 选项的详细信息，请参阅验证压缩迁移存储的条件。
/verify 语法如下：
usmtutils /verify[:<reportType>] <filePath> [/l:<logfile>] [/v:VerbosityLevel] [/decrypt [:<AlgID>] {/key:<keystring> | /keyfile:<filename>}]
| 命令行选项 | 描述 | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
<reportType> |
指定是报告所有文件、仅报告已损坏的文件还是报告目录状态。
|
||||||||||||||||||
/l: <logfilePath> |
指定日志文件的位置和名称。 |
||||||||||||||||||
/v: <VerbosityLevel> |
(Verbosity) 启用 UsmtUtils 日志文件中的详细输出。默认值为 0。 你可以将 VerbosityLevel 设置为以下级别之一：
|
||||||||||||||||||
/decrypt: <AlgID> /key:<KeyString> 或 /decrypt: <AlgID> /key:<“Key String”> 或 /decrypt: <AlgID> /keyfile:<FileName> |
指定在通过 ScanState 工具创建迁移存储时，使用 /encrypt 选项。如果要解密迁移存储，请指定 /key 或 /keyfile 选项，具体如下：
有关获支持加密算法的详细信息，请参阅迁移存储加密。 |
/verify 命令的一些示例：
usmtutils /verify D:\MyMigrationStore\store.migusmtutils /verify:catalog D:\MyMigrationStore\store.migusmtutils /verify:all D:\MyMigrationStore\store.mig /decrypt /l:D:\UsmtUtilsLog.txtusmtutils /verify:failureonly D:\MyMigrationStore\store.mig /decrypt:AES_192 /keyfile:D:\encryptionKey.txt
解压缩选项
如果无法正常通过 loadstate 恢复文件时，则使用 /extract 选项，将文件从压缩的 USMT 迁移存储中恢复。有关如何使用 /extract 选项的详细信息，请参阅从压缩 USMT 迁移存储中提取文件。
/extract 的语法如下：
/extract <filePath><destinationPath> [/i:<includePattern>] [/e: <excludePattern>] [/l: <logfile>] [/v: VerbosityLevel>] [/decrypt[:<AlgID>] {key: <keystring> | /keyfile: <filename>}] [/o]
| 命令行选项 | 描述 | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
<filePath> |
USMT 迁移存储的路径。 例如：
|
||||||||||||||||||
<destinationPath> |
工具用于存放个别文件的文件夹路径。 |
||||||||||||||||||
/i:<includePattern> |
指定解压缩中所含文件的模式。可以指定多个模式。用逗号或分号隔开各个模式。你可在相同命令中使用 /i: <includePattern> 和 /e: <excludePattern> 选项。在命令上使用包含和排除模式时，包含模式优先于排除模式。 |
||||||||||||||||||
/e:<excludePattern> |
指定从解压缩中漏掉的文件模式。可以指定多个模式。用逗号或分号隔开各个模式。你可在相同命令中使用 /i: <includePattern> 和 /e: <excludePattern> 选项。在命令上使用包含和排除模式时，包含模式优先于排除模式。 |
||||||||||||||||||
/l:<logfilePath> |
指定日志文件的位置和名称。 |
||||||||||||||||||
/v: <VerbosityLevel> |
(Verbosity) 启用 UsmtUtils 日志文件中的详细输出。默认值为 0。 你可以将 VerbosityLevel 设置为以下级别之一：
|
||||||||||||||||||
/decrypt: <AlgID> /key:<KeyString> 或 /decrypt: <AlgID> /key:<“Key String”> 或 /decrypt: <AlgID> /keyfile:<FileName> |
指定在通过 ScanState 工具创建迁移存储时，使用 /encrypt 选项。如果要解密迁移存储，则必须指定 /key 或 /keyfile 选项，具体如下：
有关获支持加密算法的详细信息，请参阅迁移存储加密。 |
||||||||||||||||||
/o |
覆盖现有的输出文件。 |
/extract 命令的一些示例：
usmtutils /extract D:\MyMigrationStore\USMT\store.mig C:\ExtractedStoreusmtutils /extract D:\MyMigrationStore\USMT\store.mig /i:"*.txt, *.pdf" C:\ExtractedStore /decrypt /keyfile:D:\encryptionKey.txtusmtutils /extract D:\MyMigrationStore\USMT\store.mig /e:*.exe C:\ExtractedStore /decrypt:AES_128 /key:password /l:C:\usmtlog.txtusmtutils /extract D:\MyMigrationStore\USMT\store.mig /i:myProject.* /e:*.exe C:\ExtractedStore /o