UsmtUtils 语法

本文介绍用户状态迁移工具中提供的实用工具的语法， (USMT) 通过命令行界面。 这些实用工具：

  • 提高确定迁移的加密选项的能力。

  • 帮助删除由于共享锁而无法删除的硬链接存储。

  • 验证目录文件或压缩迁移存储区中的任何其他文件是否已损坏。

  • 从文件和设置迁移到目标计算机时创建的压缩迁移存储中提取文件。

UsmtUtils.exe

下表列出了 的 UsmtUtils.exe命令行选项。 以下各节提供了 和 选项的/verify/extract更多命令行选项。

的 UsmtUtils.exe 语法为：

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

命令行选项 描述
/电子商务 返回当前系统上支持的加密算法列表 (AlgIDs) 。 在源计算机上运行 ScanState 工具之前，可以在目标计算机上使用此选项来确定与 命令一起使用/encrypt的算法。
/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> 指定是仅报告所有文件、损坏的文件还是目录的状态。
  • 摘要。 返回完好无损的文件数和迁移存储中损坏的文件数。 如果未指定任何算法，则摘要报告将显示为默认值。
  • all。 返回以制表符分隔的列表，该列表包含压缩的迁移存储区中的所有文件以及每个文件的状态。 每行包含文件名后跟制表符间距，根据文件的状态， “已损坏 ”或 “正常 ”。 最后一个条目报告存储的 CATALOG 的损坏状态。 目录文件包含迁移存储区中所有文件的元数据。 LoadState 工具需要有效的目录文件才能打开迁移存储区。 如果目录文件完好无损，并且 LoadState 可以打开迁移存储，则返回“OK”;如果迁移存储已损坏，则返回“CORRUPTED”。
  • failureonly。 仅返回压缩迁移存储中损坏的文件的制表符分隔列表。
  • 目录。 仅返回目录文件的状态。
/我：
<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如果使用 LoadState 无法正常还原，请使用 选项从压缩的 USMT 迁移存储中恢复文件。 有关如何使用 /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> 选项。 在命令行上同时使用包含模式和排除模式时，include 模式优先于排除模式。
/e：<excludePattern> 为要从提取中省略的文件指定模式。 可以指定多个模式。 使用逗号或分号分隔模式。 可以在 /i同一命令中使用 ： <includePattern> 和 /e： <excludePattern> 选项。 在命令行上同时使用包含模式和排除模式时，include 模式优先于排除模式。
/l：<logfilePath> 指定日志文件的位置和名称。
/v：<VerbosityLevel> (详细)

在 UsmtUtils 日志文件中启用详细输出。 默认值为 0。

VerbosityLevel 可以设置为以下级别之一：
  • 0 - 仅启用默认错误和警告。
  • 1 - 启用详细输出。
  • 4 - 启用错误和状态输出。
  • 5 - 启用详细和状态输出。
  • 8 - 启用错误输出到调试器。
  • 9 - 启用调试器的详细输出。
  • 12 - 启用调试器的错误和状态输出。
  • 13 - 启用详细、状态和调试器输出。
/decrypt*<AlgID>/key：<KeyString>
或
/解密<AlgID>/：<“键字符串”>
或
/解密：<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