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> 参数指定的目录路径。你可以使用此命令删除因共享锁定而无法在命令提示符下删除的硬链接迁移存储。如果迁移存储跨越指定驱动器上的多个卷,则从所有这些卷中将它删除。

例如:

usmtutils /rd D:\MyHardLinkStore

/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>

指定是报告所有文件、仅报告已损坏的文件还是报告目录状态。

  • Summary。返回完整文件的数量以及在迁移存储中损坏的文件数量。如未指定算法,则将默认显示摘要报告。

  • all。返回压缩的迁移存储中所有文件的制表符分隔列表以及每个文件的状态。每行都含有附带标签间距以及“已损坏”或“没问题”字样的文件名,具体取决于文件状态。最后一个条目报告存储“目录”的损坏状态。目录文件含有迁移存储中所有文件的元数据。LoadState 工具需要有效的目录文件,以便打开迁移存储。如果目录文件完整,并且 LoadState 可以打开迁移存储,则返回“没问题”;如果迁移存储已损坏,则返回“已损坏”。

  • failureonly。仅返回压缩迁移存储中已损坏的文件的制表符分隔列表。

  • Catalog。仅返回目录文件的状态。

/l: <logfilePath>

指定日志文件的位置和名称。

/v: <VerbosityLevel>

(Verbosity)

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

你可以将 VerbosityLevel 设置为以下级别之一:

 

级别 说明

0

仅启用默认错误和警告。

1

启用详细输出。

4

启用错误和状态输出。

5

启用详细和状态输出。

8

启用至调试程序的错误输出。

9

启用至调试程序的详细输出。

12

启用至调试程序的错误和状态输出。

13

启用详细、状态和调试程序输出。

/decrypt: <AlgID> /key:<KeyString>

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

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

指定在通过 ScanState 工具创建迁移存储时,使用 /encrypt 选项。如果要解密迁移存储,请指定 /key/keyfile 选项,具体如下:

  • <AlgID> 指定在 ScanState 命令行上创建迁移存储时,使用加密算法。如未指定任何算法,则 ScanState 和 UsmtUtils 将默认使用 3DES 算法。

    <AlgID> 有效值包括:AES_128、AES_192、AES_256、3DES 或 DES_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

解压缩选项

如果无法正常通过 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 迁移存储的路径。

例如:

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:<“Key String”>

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

指定在通过 ScanState 工具创建迁移存储时,使用 /encrypt 选项。如果要解密迁移存储,则必须指定 /key/keyfile 选项,具体如下:

  • <AlgID> 指定在 ScanState 命令行上创建迁移存储时,使用加密算法。如未指定任何算法,则 ScanState 和 UsmtUtils 将默认使用 3DES 算法。

    <AlgID> 有效值包括:AES_128、AES_192、AES_256、3DES 或 DES_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

另请参阅

其他资源

用户状态迁移工具 (USMT) 命令行语法
返回代码