LoadState 语法

项目
11/25/2013

本主题讨论 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。

/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 元素库