LoadState 语法

本主题讨论 LoadState 命令语法和选项。

本主题内容

开始之前

语法

存储选项

迁移规则选项

监控选项

用户选项

不兼容的命令行选项

开始之前

在运行 LoadState 命令之前，注意以下各项：

• 为确保迁移所有操作系统设置，我们建议你通过有管理凭据的帐户在管理员模式下运行 LoadState 命令。

• 有关运行 LoadState 命令的软件要求的信息，请参阅USMT 要求。

• 你应在运行 LoadState 命令后注销。有些设置（例如字体、墙纸和屏幕保护程序设置）将在用户下次登录时生效。

• 除非另有指示，否则在命令行上运行工具时，每个选项只可使用一次。

• LoadState 无需域控制器访问权限，即可应用域配置文件。此功能无需任何额外配置即可使用。当使用 ScanState 收集用户配置文件时，源计算机无需具有域控制器访问权限。但是，除非目标计算机连接到域，否则将无法访问域配置文件。

• 不兼容的命令行选项 表列出你可同时使用的选项以及不兼容的命令行选项。

语法

本部分介绍了使用 LoadState 命令时可用的命令行选项的语法和用法。可按任何顺序指定这些选项。如果选项含有一个参数，则可指定冒号或空格分隔符。

LoadState 命令的语法是：

loadstate StorePath [/i:[Path\]FileName] [/v:VerbosityLevel] [/nocompress] [/decrypt /key:KeyString|/keyfile:[Path\]FileName] [/l:[Path\]FileName] [/progress:[Path\]FileName] [/r:TimesToRetry] [/w:SecondsToWait] [/c] [/all] [/ui:[DomainName|ComputerName\]UserName] [/ue:[[DomainName|ComputerName\]UserName] [/uel:NumberOfDays|YYYY/MM/DD|0] [/md:OldDomain:NewDomain] [/mu:OldDomain\OldUserName:[NewDomain\]NewUserName] [/lac:[Password]] [/lae] [/config:[Path\]FileName] [/?|help]

例如，若要解密存储以及将文件和设置迁移到运行 Windows Vista 或 Windows 7 的计算机，请在命令行上键入以下内容：

loadstate \\server\share\migration\mystore /i:migapp.xml /i:migdocs.xml /v:13 /decrypt /key:"mykey"

存储选项

USMT 提供以下可用于指定迁移数据的存储方式和位置的选项。

命令行选项	说明
StorePath	指明存储文件和设置数据的文件夹。当使用 LoadState 命令时，你必须指定 StorePath。你可以指定多个 StorePath。
/decrypt /key:KeyString 或 /decrypt /key:"Key String" 或 /decrypt /keyfile:[Path\]FileName	解密有指定密钥的存储。利用此选项，你必须按以下方式之一指定加密密钥： /key: KeyString 可指定加密密钥。如果 KeyString 中有空格，你必须在参数两边加引号。 /keyfile: FilePathAndName 可指定含有加密密钥的文本 (.txt) 文件 KeyString 不能超过 256 个字符。 /key 和 /keyfile 选项不能在同一命令行上使用。 /decrypt 和 /nocompress 选项不能在同一命令行上使用。 > [!IMPORTANT] > 使用此选项时应特别小心，这是因为有权访问 LoadState 命令行脚本的任何人也有权访问加密密钥。 > 例如： loadstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore /decrypt /key:mykey
/decrypt: “加密强度”	/decrypt 选项接受命令行参数，以定义为迁移存储加密指定的加密强度。有关受支持的加密算法的详细信息，请参阅迁移存储加密。
/hardlink	可从硬链接迁移存储中恢复用户状态数据。必须通过 /hardlink 选项指定 /nocompress 参数。
/nocompress	指明存储未经压缩。你仅可在测试环境中使用此选项。我们建议你在实际迁移期间使用压缩的存储。此选项不能与 /decrypt 选项一起使用。 例如： loadstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore /nocompress

迁移规则选项

USMT 提供了以下选项，可以通过这些选项指定要迁移的文件。

命令行选项	说明
/i:[Path\]FileName	(include) 指定含有可定义迁移状态的规则的 .xml 文件。你可以多次指定此选项，以包含所有 .xml 文件（MigApp.xml、MigSys.xml、MigDocs.xml 以及任何你创建的自定义 .xml 文件）。路径可以是相对路径或完整路径。如果你不指定 Path 变量，则 FileName 必须位于当前目录中。 有关要指定哪些文件的详细信息，请参阅常见问题主题中的“XML 文件”部分。
/config:[Path\]FileName	指定 LoadState 命令应使用的 Config.xml 文件。你不能在命令行上多次指定此选项。路径可以是相对路径或完整路径。如果你不指定 Path 变量，则 FileName 必须位于当前目录中。 此示例根据 Config.xml、MigDocs.xml 以及 MigApp.xml 文件中的规则迁移文件和设置： loadstate \\server\share\migration\mystore /config:config.xml /i:migdocs.xml /i:migapp.xml /v:5 /l:loadstate.log
/auto: “脚本文件路径”	此选项可让你指定默认 .xml 文件的位置，然后启动迁移。如果不指定任何路径，USMT 将使用 USMT 二进制文件所在的目录。/auto 选项的使用效果与以下选项相同：/i:MigDocs.xml/i:MigApp.xml /v:5。

监控选项

USMT 提供了若干命令行选项，通过这些命令行选项可以分析在迁移过程中发生的问题。

命令行选项	说明
/l:[Path\]FileName	指定 LoadState 日志的位置和名称。你不能在 StorePath 中存储任何日志文件。Path 可以是相对路径或完整路径。如果你不指定 Path 变量，则将在当前目录中创建日志。你可以指定 /v 选项，以调节输出量。 如果从共享网络资源运行 LoadState 命令，则必须指定此选项，否则 USMT 将失败并出现错误“USMT 无法创建日志文件”。若要修复此问题，请使用 /l:load.log 选项。
/v: <VerbosityLevel>	(Verbosity) 启用 LoadState 日志文件中的详细输出。默认值为 0。 你可以将 VerbosityLevel 设置为下列级别之一：   级别 说明 0 仅启用默认错误和警告。 1 启用详细输出。 4 启用错误和状态输出。 5 启用详细和状态输出。 8 启用至调试程序的错误输出。 9 启用至调试程序的详细输出。 12 启用至调试程序的错误和状态输出。 13 启用详细、状态和调试程序输出。 </div> <p>例如：</p> <p> <code>loadstate \\server\share\migration\mystore /v:5 /i:migdocs.xml /i:migapp.xml</code> </p> </td> </tr> <tr> <td colspan="1"> <p> <strong>/progress:</strong>[<em>Path\</em>]<em>FileName</em></p> </td> <td colspan="1"> <p>创建可选的进度日志。请勿在 <em>StorePath</em> 中存储任何日志文件。<em>Path</em> 可以是相对路径或完整路径。如果不指定 <em>Path</em> 变量，则将在当前目录中创建 <em>FileName</em>。</p> <p>例如：</p> <p> <code>loadstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore /progress:prog.log /l:scanlog.log</code> </p> </td> </tr> <tr> <td> <p> <strong>/c</strong> </p> </td> <td> <p>指定此选项时，即使出现非致命错误，<strong>LoadState</strong> 命令仍会继续运行。任何引发错误的文件或设置均已记录在进度日志中。例如，如果计算机上有不适用的大文件，<strong>LoadState</strong> 命令将记录错误，并继续执行迁移。在没有 <strong>/c</strong> 选项的情况下，<strong>LoadState</strong> 命令将在发生第一个错误时退出。你可以使用 Config.xml 文件中新的 &lt;<strong>ErrorControl</strong>&gt; 部分，指定哪些文件或注册表项读/写错误是可以安全忽略的，以及哪些原因可能会导致迁移失败。这可让 <strong>/c</strong> 命令行选项安全跳过环境中的所有输入/输出 (I/O) 错误。此外，<strong>/genconfig</strong> 选项现可生成示例 &lt;<strong>ErrorControl</strong>&gt; 部分，指定 Config.xml 文件中的错误信息和所需行为即可启用该部分。</p> </td> </tr> <tr> <td colspan="1"> <p> <strong>/r:</strong> <em>&lt;TimesToRetry&gt;</em> </p> </td> <td colspan="2"> <p> <strong>（重试）</strong> </p> <p>指定在从服务器中迁移用户状态过程中发生错误时的重试次数。默认值是 3 次。此选项在网络连接不太可靠的环境中尤为有用。</p> <p>当恢复用户状态时，<strong>/r</strong> 选项将无法恢复在网络硬件故障（如网络电缆故障或断开连接）时或者在虚拟专用网络 (VPN) 连接失败时丢失的数据。重试选项适用于繁忙的大型网络，此类网络的连接令人满意，但存在通信延迟问题。</p> </td> </tr> <tr> <td colspan="1"> <p> <strong>/w:</strong> <em>&lt;SecondsBeforeRetry&gt;</em> </p> </td> <td colspan="2"> <p> <strong>（等待）</strong> </p> <p>指定重试网络文件操作之前要等待的时间（以秒为单位）。默认值是 1 秒。</p> </td> </tr> <tr> <td colspan="1"> <p> <strong>/?</strong> 或 <strong>/help</strong></p> </td> <td colspan="2"> <p>在命令行上显示帮助。</p> </td> </tr> </table> 用户选项 在默认情况下迁移所有用户。以下选项是指定要包含和排除的用户的唯一方法。你不能在迁移 .xml 文件中或使用 Config.xml 文件排除用户。有关详细信息，请参阅标识用户。 命令行选项 说明 /all 迁移计算机上的所有用户。 USMT 将迁移计算机上的所有帐户，除非你通过 /ue 或 /uel 选项明确排除某个帐户。为此，你无需在命令行上指定此选项。但是，如果选择使用 /all 选项，则无法也使用 /ui、/ue 或 /uel 选项。 /ui: DomainName\UserName 或 /ui:"DomainName\User Name" 或 /ui: ComputerName\LocalUserName （包含用户） 迁移指定的用户。在默认情况下，迁移包含所有用户。因此，此选项仅在与 /ue 选项一起使用时才有用。你可以指定多个 /ui 选项，但不能同时使用 /ui 选项和 /all 选项。DomainName 和 UserName 可以包含星号 (*) 通配符。当你指定含有空格的用户名时，你必须在用户名两边加上引号。 例如： 若要仅包含企业域中的 User2，请键入： /ue:*\* /ui:corporate\user2 备注 如果通过 /ui 选项指定要包含某个用户，但又通过 /ue 或 /uel 选项指定要排除该用户，则该用户将包含在迁移中。 有关更多示例，请参阅此表中有关 /uel、/ue 和 /ui 选项的描述。 /uel:<NumberOfDays> 或 /uel:<YYYY/MM/DD> 或 /uel:0 （根据上次登录时间排除用户） 根据源计算机上 Ntuser.dat 文件的上次修改日期，迁移在指定时段内登录到源计算机的用户。/uel 选项充当包含规则。例如，/uel:30 选项将仅迁移过去 30 天内运行 ScanState 命令时登录或修改帐户的用户。 你可以指定数天或某一天。你不能同时使用此选项和 /all 选项。USMT 从本地计算机中检索最近登录信息，以便你运行此选项时，无需将计算机连接到网络。此外，如果域用户已登录到其他计算机，则 USMT 将不考虑登录实例。 备注 /uel 选项在脱机迁移中无效。 示例： /uel:0 将迁移在运行 ScanState 命令时已经登录到源计算机的帐户。 /uel:90 将迁移在过去的 90 天内登录或者修改帐户的用户。 /uel:1 将迁移在过去 24 小时内修改其帐户的用户。 /uel:2002/1/15 迁移自 2002 年 1 月 15 日起登录或修改其帐户的用户。 例如： loadstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore /uel:0 /ue:DomainName\UserName 或 /ue:"DomainName\User Name" 或 /ue:ComputerName\LocalUserName （排除用户） 从迁移中排除指定的用户。你可以指定多个 /ue 选项，但不能同时使用 /ue 选项和 /all 选项。DomainName 和 DomainName 可以包含星号 (*) 通配符。当指定含有空格的用户名时，必须在用户名两边加上引号。 例如： loadstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore /ue:contoso\user1 有关更多示例，请参阅此表中有关 /uel、/ue 和 /ui 选项的描述。 /md: OldDomain:NewDomain 或 /md: LocalComputerName:NewDomain （移动域） 指定新的用户域。使用此选项，更改计算机上的用户域，或将本地用户迁移至域帐户。OldDomain 可以包含星号 (*) 通配符。 你不能多次指定此选项。如果打算将多个域中的用户合并到单个域中，则可能会指定多个 /md 选项。例如，你将指定以下选项，以便将企业域和 FarNorth 域中的用户合并到 Fabrikam 域中：/md:corporate:fabrikam 和 /md:farnorth:fabrikam。 如果两个 /md 命令之间存有冲突，则应用你指定的第一条规则。例如，如果你指定 /md:corporate:fabrikam 和 /md:corporate:farnorth 命令，则企业用户将映射到 Fabrikam 域。 备注 如果你指定源计算机中不存在的 OldDomain，则 LoadState 命令将似乎完全成功，而无任何错误或警告。但是，在这种情况下，用户将不被移到 NewDomain，而将留在其原始域中。例如，如果你错误拼写“contoso”，并且指定“/md:contso:fabrikam”，则用户将保留在目标计算机的 contoso 上。 例如： loadstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore /progress:prog.log /l:load.log /md:contoso:fabrikam /mu: OldDomain\OldUserName:[NewDomain\]NewUserName 或 /mu: OldLocalUserName:NewDomain\NewUserName 为特定用户指定一个新的用户名。如果存储含有多个用户，你可以指定多个 /mu 选项。你不能将通配符用于此选项。 例如： loadstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore /progress:prog.log /l:load.log /mu:contoso\user1:fabrikam\user1 /lac:[Password] （本地帐户创建） 指明如果用户帐户是本地帐户（而非域帐户），并且它不存在目标计算机上，则 USMT 将在目标计算机上创建帐户，但该帐户将被禁用。若要启用帐户，你还必须使用 /lae 选项。 如未指定 /lac 选项，则不会迁移任何目标计算机上还不存在的本地用户帐户。 Password 是新建帐户的密码。默认情况下使用的是空密码。 注意 使用 Password 变量时要格外小心，因为密码是以纯文本的形式提供，任何可访问正在运行 LoadState 命令的计算机的人员都能获取此密码。 另外，如果计算机有几个用户，则所有迁移的用户将拥有相同的密码。 例如： loadstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore 有关说明的详细信息，请参阅迁移用户帐户。 /lae （本地帐户启用） 启用通过 /lac 选项创建的帐户。你必须通过此选项指定 /lac 选项。 例如： loadstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore /progress:prog.log /l:load.log /lac:password /lae 有关说明的详细信息，请参阅迁移用户帐户。 /ui 和 /ue 选项的示例 以下示例适用于 /ui 和 /ue 选项。你可以用 /ui 选项代替 /ue 选项，以包含（而非排除）指定的用户。 行为 命令 排除企业域中名为 User One 的用户 /ue:"corporate\user one" 排除企业域中名为 User1 的用户。 /ue:corporate\user1 排除名为 User1 的本地用户。 /ue:%computername%\user1 排除所有域用户。 /ue:Domain\* 排除所有本地用户。 /ue:%computername%\* 排除所有域中名为 User1 和 User2 等的用户。 /ue:*\user* 同时使用各个选项 你可以同时使用 /uel、/ue 和 /ui 选项，以仅迁移你想迁移的用户。 **/ui 选项优先于 /ue 和 /uel 选项。**如果使用 /ui 选项指定要包含某个用户，但又使用 /ue 或 /uel 选项排除该用户，则该用户将包含在迁移中。例如，如果你指定 /ui:contoso\* /ue:contoso\user1，则将迁移 User1，因为 /ui 选项优先于 /ue 选项。 **/uel 选项优先于 /ue 选项。**如果某个用户在 /uel 选项设置的指定时间内登录，则将迁移该用户的配置文件，即使使用 /ue 选项排除了该用户也是如此。例如，如果你指定 /ue:contoso\user1 /uel:14，则将迁移在过去 14 天登录该计算机的 User1。 行为 命令 仅包含 Fabrikam 域中的 User2，并且排除所有其他用户。 /ue:*\* /ui:fabrikam\user2 仅包含名为 User1 的本地用户，并且排除所有其他用户。 /ue:*\* /ui:user1 仅包含 Contoso 中的域用户，除 Contoso\User1 外。 使用单个命令不能完成此行为。相反，如要迁移这组用户，你必须指定以下各项： 使用 ScanState 命令行工具，输入：/ue:*\* /ui:contoso\* 使用 LoadState 命令行工具，输入：/ue:contoso\user1 仅包含本地用户（非域用户）。 /ue:*\* /ui:%computername%\* 不兼容的命令行选项 下表指出哪个命令行选项与 LoadState 命令不兼容。如果特定选项组合的表条目为空，则各个选项都是兼容的，你可以同时使用它们。X 符号意味着各个选项不兼容。例如，你不能同时使用 /nocompress 选项和 /encrypt 选项。 命令行选项 /keyfile /nocompress /genconfig /all /i /v /nocompress 不适用 X /key X X /decrypt 必需* X X /keyfile 不适用 X /l /progress X /r X /w X /c X /p X 不适用 /all X /ui X X /ue X X /uel X X /genconfig 不适用 /config X StorePath /md /mu /lae /lac 备注 你必须通过 /encrypt 选项指定 /key 或 /keyfile 选项。 另请参阅 其他资源 XML 元素库