ScanState 语法
ScanState 命令与 用户状态迁移工具 (USMT) 5.0 一起使用,可扫描源计算机,收集文件和设置,并且创建存储。
本主题内容
开始之前
语法
存储选项
迁移规则选项
监控选项
用户选项
加密文件选项
不兼容的命令行选项
开始之前
在运行 ScanState 命令之前,请注意以下各项:
为确保迁移所有操作系统设置,在大多数情况下,你必须使用具有管理凭据的帐户在管理员模式下运行 ScanState 命令。
如要加密迁移存储,则需输入加密密钥或包含加密密钥的文件路径。必须记录密钥或密钥文件的位置,因为此类信息尚未保存在迁移存储中的任何位置。当运行 LoadState 命令以解密迁移存储时,或在必须运行恢复实用程序的情况下,你需要使用此类信息。密钥或密钥文件不正确或丢失都会引发错误消息。
有关运行 ScanState 命令的软件要求的信息,请参阅USMT 要求。
重要
Windows XP 和 Windows Vista® 仅可作为源计算机上的操作系统获得支持。
除非另有指示,否则在命令行上运行工具时,每个选项只可使用一次。
你可以在源计算机未访问域控制器的情况下,收集域帐户。此功能无需任何额外配置即可使用。
不兼容的命令行选项表列出了哪些选项可以一起使用,哪些命令行选项不兼容。
将从扫描中排除保存迁移存储的目录位置。例如,如果你将迁移存储保存到 D 驱动器的根目录,将从扫描中排除 D 驱动器及其所有子目录。
语法
本部分介绍了 ScanState 命令行选项的语法和用法。可以按任何顺序指定这些选项。如果选项包含一个参数,则可以使用冒号或空格分隔符。
ScanState 命令的语法是:
scanstate [StorePath] [/i:[Path\]FileName] [/o] [/v:VerbosityLevel] [/nocompress] [/localonly] [/encrypt /key:KeyString|/keyfile:[Path\]FileName] [/l:[Path\]FileName] [/progress:[Path\]FileName] [/r:TimesToRetry] [/w:SecondsBeforeRetry] [/c] [/p] [/all] [/ui:[DomainName|ComputerName\]UserName] [/ue:[DomainName|ComputerName\]UserName] [/uel:NumberOfDays|YYYY/MM/DD|0] [/efs:abort|skip|decryptcopy|copyraw] [/genconfig:[Path\]FileName[/config:[Path\]FileName] [/?|help]
例如:
若要在当前目录中创建 Config.xml 文件,请使用:
scanstate /i:migapp.xml /i:migdocs.xml /genconfig:config.xml /v:13
若要使用 Config.xml 文件和默认迁移 .xml 文件创建加密存储,请使用:
scanstate \\server\share\migration\mystore /i:migapp.xml /i:migdocs.xml /o /config:config.xml /v:13 /encrypt /key:"mykey"
存储选项
命令行选项 | 描述 |
---|---|
StorePath |
指明用于保存文件和设置的文件夹。请注意,StorePath 不能为 c:\。你必须在 ScanState 命令中指定 StorePath 选项,但在使用 /genconfig 选项时除外。不能指定多个 StorePath 位置。 |
/o |
需要覆盖迁移存储或 Config.xml 文件中的任何现有数据。如未指定,则在迁移存储中已经包含数据时,ScanState 命令将会失败。在一个命令行中无法多次使用此选项。 |
/vsc |
此选项启用卷影复制服务以迁移锁定的或使用中的文件。此命令行选项可消除 <ErrorControl> 部分普遍遇到的大多数文件锁定错误。 此选项仅能与 ScanState 可执行文件一起使用,不能与 /hardlink 选项配合使用。 |
/hardlink |
能够在指定位置创建硬链接迁移存储。必须同时指定 /nocompress 选项和 /hardlink 选项。 |
/encrypt [{/key:<KeyString> | /keyfile:<file>]} |
用指定的密钥加密存储。默认情况下禁用加密。如果使用此选项,则需要通过以下方式之一指定加密密钥:
建议 KeyString 的长度至少为 8 个字符,但不能超过 256 个字符。/key 和 /keyfile 选项不能在同一命令行上使用。/encrypt 和 /nocompress 选项不能在同一命令行上使用。 > [!IMPORTANT] > 在使用此选项时应特别小心,这是因为有权访问 ScanState 命令行脚本的任何人也有权访问加密密钥。 >以下示例显示了 ScanState 命令和 /key 选项:
|
/encrypt:<EncryptionStrength> |
/encrypt 选项接收命令行参数,以定义用于迁移存储加密的加密强度。有关支持加密算法的详细信息,请参阅迁移存储加密。 |
/nocompress |
禁用数据压缩并将文件保存在 StorePath\USMT 中名为“文件”的隐藏文件夹中。默认情况下将启用“压缩”。将 /nocompress 选项和 /hardlink 选项结合使用,生成一个硬链接迁移存储。可以使用未压缩存储查看 USMT 存储了哪些内容,进行问题疑难解答,或者对文件运行防病毒实用程序。你应仅在测试环境中使用此选项,因为我们建议你在实际迁移期间使用压缩存储,除非你将 /nocompress 选项和 /hardlink 选项结合使用。 /nocompress 和 /encrypt 选项不能在命令行中的一个语句中同时使用。不过,如果确实需要选择迁移未压缩存储,LoadState 命令会将每个文件从存储直接迁移到目标计算机上的正确位置,而无需临时位置。 例如:
|
在脱机 Windows 系统中运行 ScanState 命令
可以在 Windows PE 中运行 ScanState 命令。此外,USMT 支持从 Windows.old 目录包含的以前 Windows 安装中进行迁移。在 Windows PE 中运行 ScanState 命令时,脱机目录是 Windows 目录;在 Windows 中运行 ScanState 命令时,脱机目录是 Windows.old 目录。
在脱机 Windows 映像中运行 ScanState 命令有几个好处,包括:
改善性能。
因为 Windows PE 是精简的操作系统,所以运行的服务比较少。在此环境中,ScanState 命令可以访问本地硬件资源更多次,使 ScanState 能够更快执行迁移操作。
简化的端到端部署过程。
从 Windows.old 迁移数据简化了端到端部署过程,方法是在安装新操作系统后进行迁移。
提高迁移成功率。
迁移成功率升高,因为脱机时不会锁定文件进行编辑,Windows PE 会提供对脱机 Windows 文件系统中文件的管理员访问权限,消除了对联机系统的管理员级别访问权限的需要。
可恢复无法启动的计算机。
可以恢复无法启动的计算机以及从其中迁移数据。
脱机迁移选项
命令行选项 | 定义 |
---|---|
/offline: “脱机 .xml 文件的路径” |
此选项用来定义脱机 .xml 文件的路径,该文件可指定其他脱机迁移选项,例如,迁移中所需的脱机 Windows 目录、任何域或者文件夹重定向。 |
/offlinewindir: “Windows 目录的路径” |
此选项指定脱机 Windows 目录,ScanState 命令从脱机 Windows 目录中收集用户状态。在 Windows 中运行 ScanState 命令时,脱机目录是 Windows.old 目录;在 Windows PE 中运行 ScanState 命令时,脱机目录是 Windows 目录。 |
/offlinewinold: “Windows.old 目录” |
此命令行选项可启用脱机迁移模式,并从指定的位置开始迁移。该选项仅适用于从 Windows.old 目录迁移的 Windows.old 迁移方案。 |
迁移规则选项
USMT 提供了以下选项,可以通过这些选项指定要迁移的内容。
命令行选项 | 描述 | ||||||||
---|---|---|---|---|---|---|---|---|---|
/i:[Path\]FileName |
(包含) 指定一个 .xml 文件,该文件包含的规则定义要迁移的用户、应用程序或者系统状态。可以多次指定此选项,以便包含所有 .xml 文件(MigApp.xml、MigDocs.xml 和任何创建的自定义 .xml 文件)。Path 可以是相对路径或完整路径。如果不指定 Path 变量,则 FileName 必须位于当前目录中。有关要指定哪些文件的详细信息,请参阅常见问题主题中的“XML 文件”部分。 |
||||||||
/genconfig:[Path\]FileName |
(生成 Config.xml) 生成可选的 Config.xml 文件,但不创建迁移存储。为确保此文件包含可以迁移的每个组件、应用程序和设置,应在包含要在目标计算机上显示的所有组件、应用程序和设置的源计算机上创建此文件。此外,在指定此选项时,还应使用 /i 选项指定其他迁移 .xml 文件。 在创建此文件后,需要使用 /config 选项和 ScanState 命令来利用该文件。 可以使用此选项指定的选项只有 /i、/v 和 /l 选项。无法指定 StorePath,因为 /genconfig 选项不创建存储。Path 可以是相对路径或完整路径。如果不指定 Path 变量,则将在当前目录中创建 FileName。 示例:
|
||||||||
/config:[Path\]FileName |
指定 ScanState 命令用来创建存储的 Config.xml 文件。在命令行中无法多次使用此选项。Path 可以是相对路径或完整路径。如果不指定 Path 变量,则 FileName 必须位于当前目录中。 以下示例使用 Config.xml、MigDocs.xml 和 MigApp.xml 文件创建一个存储:
以下示例使用 Config.xml、MigDocs.xml 和 MigApp.xml 文件将文件和设置迁移到目标计算机:
|
||||||||
/auto: 脚本文件路径 |
此选项可让你指定默认 .xml 文件的位置,然后启动迁移。如果不指定路径,则 USMT 将参考 USMT 二进制文件所在的目录。/auto 选项的使用效果与以下选项相同:/i:MigDocs.xml/i:MigApp.xml /v:5。 |
||||||||
/genmigxml: 文件路径 |
此选项指定 ScanState 命令应该使用文档查找器来创建和导出 .xml 文件,该文件定义如何迁移正在运行 ScanState 命令的计算机上所有文件。 |
||||||||
/localonly |
无论在命令行中指定的 .xml 文件中的规则如何,仅迁移本地计算机上存储的文件。当要排除源计算机上可移动驱动器中的数据(例如 U 盘 (UFD)、一些外部硬盘驱动器等)以及有网络驱动器映射到源计算机时,应使用此选项。如果没有指定 /localonly 选项,则 ScanState 命令会将文件从这些可移动驱动器或者网络驱动器复制到存储中。 任何 OS 认为不是固定驱动器的驱动器都会由 /localonly 排除。在某些情况下,大型外部硬盘驱动器可视为固定的驱动器。这些驱动器可以使用自定义 .xml 文件从迁移中明确排除。有关如何排除特定驱动器上的所有文件的详细信息,请参阅排除文件和设置。 /localonly 命令行选项在迁移中按照以下表格中的确认情况,包含或排除数据:
|
监控选项
USMT 提供了若干选项,通过这些选项可以分析在迁移过程中发生的问题。
备注 |
---|
默认情况下将创建 ScanState 日志,但是可以使用 /l 选项指定日志的名称和位置。 |
命令行选项 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
/listfiles:<FileName> |
可以将 /listfiles 命令行选项与 ScanState 命令结合使用生成一个文本文件,该文件列出了迁移中包含的所有文件。 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
/l:[Path\]FileName |
指定 ScanState 日志的位置和名称。 请勿在 StorePath 中存储任何日志文件。Path 可以是相对路径或完整路径。如果不指定 Path 变量,则将在当前目录中创建日志。你可以使用 /v 选项调整输出量。 如果从共享网络资源运行 ScanState 或 LoadState 命令,则必须指定此选项,否则 USMT 将失败,并出现错误“USMT 无法创建日志文件”。若要解决此问题,请使用 /l:scan.log 命令。 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
/v: <VerbosityLevel> |
(Verbosity) 在 ScanState 日志文件中启用详细输出。默认值为 0。 你可以将 VerbosityLevel 设置为下列级别之一:
用户选项在默认情况下迁移所有用户。以下选项是指定要包含和排除的用户的唯一方法。无法排除迁移 .xml 文件中的用户或使用 Config.xml 文件的用户。有关详细信息,请参阅标识用户和迁移用户帐户。
如何使用 /ui 和 /ue以下示例适用于 /ui 和 /ue 选项。可以将 /ue 选项替换为 /ui 选项,以包含(而非排除)指定的用户。
同时使用各个选项可以一起使用 /uel、/ue 和 /ui 选项,以仅迁移你想迁移的用户。 **/ui 选项优先于 /ue 和 /uel 选项。**如果使用 /ui 选项指定要包含某个用户,但又使用 /ue 或 /uel 选项排除该用户,则该用户将包含在迁移中。例如,如果指定 **/uel 选项优先于 /ue 选项。**如果某个用户在 /uel 选项设置的指定时间内登录,则将迁移该用户的配置文件,即使使用 /ue 选项排除了该用户。例如,如果指定
加密文件选项可以使用以下选项迁移加密文件。在所有情况以及默认情况下,如果发现加密文件,USMT 都会失败(除非指定 /efs 选项)。为迁移加密文件,必须更改默认行为。 有关详细信息,请参阅迁移 EFS 文件和证书。
备注 在迁移加密文件时应格外小心。如果在迁移加密文件时没有迁移证书,则在迁移之后最终用户将无法访问该文件。
不兼容的命令行选项下表指出哪个命令行选项与 ScanState 命令不兼容。如果特定选项组合的表项为空,则各个选项都是兼容的,你可以同时使用它们。X 符号表示相应选项不兼容。例如,不能将 /nocompress 选项与 /encrypt 选项一同使用。
另请参阅其他资源 |