ScanState 语法

          </div>
          <p>例如：</p>
          <p>
            <code>scanstate \\server\share\migration\mystore /v:13 /i:migdocs.xml /i:migapp.xml</code>
          </p>
          <p>
            
          </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>scanstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore /progress:prog.log /l:scanlog.log</code>
          </p>
        </td>
      </tr>
      <tr>
        <td colspan="1">
          <p>
            <strong>/c</strong>
          </p>
        </td>
        <td colspan="2">
          <p> 指定此选项时，即使出现非致命错误，<strong>ScanState</strong> 命令仍会继续运行。任何引发错误的文件或设置均已记录在进度日志中。例如，如果存储中有不适用的大文件，<strong>ScanState</strong> 命令将记录错误，并继续执行迁移。此外，如果某个文件由应用程序打开或使用，则 USMT 可能无法迁移该文件，并会记录错误。如无 <strong>/c</strong> 选项，<strong>ScanState</strong> 命令将在产生第一个错误时退出。</p>
          <p>你可以使用 Config.xml 文件中新的 <strong>&lt;ErrorControl&gt;</strong> 部分，指定哪些文件或注册表项读/写错误是可以安全忽略的，以及哪些原因可能会导致迁移失败。这可让 <strong>/c</strong> 命令行选项安全跳过环境中的所有输入/输出 (I/O) 错误。此外，<strong>/genconfig</strong> 选项现可生成示例 <strong>&lt;ErrorControl&gt;</strong> 部分；指定 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>
          <p>
            <strong>/p:</strong>
            <em>&lt;pathToFile&gt;</em>
          </p>
        </td>
        <td>
          <p>
            <strong>ScanState</strong> 命令运行时，会在指定路径中创建一个 .xml 文件。此 .xml 文件包括迁移存储已改进的空间估计。以下示例说明如何创建此 .xml 文件：</p>
          <p>
            <code>Scanstate.exe C:\MigrationLocation [additional parameters]</code>
          </p>
          <p>
            <code>/p:"C:\MigrationStoreSize.xml"</code>
          </p>
          <p>有关详细信息，请参阅<a runat="server" href="hh825132(v=win.10).md">估计迁移存储大小</a>。</p>
          <p>若要保留需要 USMT 以前行为的现有应用程序或脚本的功能，可以使用 <strong>/p</strong> 选项，无需在 USMT 中指定<em>“pathtoafile”</em>。如果你仅指定 <strong>/p</strong> 选项，则创建存储空间估计的方式与 USMT3.x 版本相同。</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: <ComputerName>\<LocalUserName>	（包含用户） 迁移指定的用户。在默认情况下，迁移包含所有用户。因此，此选项仅在与 /ue 或 /uel 选项一起使用时才显得尤为有用。可以指定多个 /ui 选项，但无法将 /ui 选项与 /all 选项一起使用。域名和用户名可以包含星号 (*) 通配符。当你指定含有空格的用户名时，你必须在用户名两边加上引号。 备注 如果通过 /ui 选项指定包含某个用户，但又通过 /ue 或 /uel 选项指定排除该用户，则该用户将包含在迁移中。 例如： 若要仅包含 Fabrikam 域中的 User2，请键入： /ue:*\* /ui:fabrikam\user2 若要迁移 Fabrikam 域中的所有用户以及其他域中仅在过去 30 日内活动或修改的用户帐户，请键入： /uel:30 /ui:fabrikam\* 在本示例中，不会迁移最后修改时间在两个月前的 Contoso 域中的用户帐户。 如要获得更多示例，请参阅此表格中有关 /ue 和 /ui 选项的描述。
/uel: <NumberOfDays> 或 /uel: <YYYY/MM/DD> 或 /uel:0	（根据上次登录时间排除用户） 根据源计算机上 Ntuser.dat 文件的上次修改日期，迁移在指定时段内登录到源计算机的用户。/uel 选项充当包含规则。例如，/uel:30 选项将仅迁移过去 30 天内运行 ScanState 命令时登录或修改帐户的用户。 你可以指定数天或某一天。你不能同时使用此选项和 /all 选项。USMT 从本地计算机中检索最近登录信息，以便你运行此选项时，无需将计算机连接到网络。此外，如果域用户已登录到其他计算机，则 USMT 将不考虑登录实例。 备注 在脱机迁移中，/uel 选项无效。 /uel:0 将迁移当前登录的任何用户。 /uel:90 将迁移在过去的 90 天内登录或者修改帐户的用户。 /uel:1 将迁移在过去的 24 小时内修改帐户的用户。 /uel:2002/1/15 将迁移 2002 年 1 月 15 日当日或之后登录或修改帐户的用户。 例如： scanstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore /uel:0
/ue: <DomainName>\<UserName> 或者 /ue: <ComputerName>\<LocalUserName>	（排除用户） 从迁移中排除指定的用户。可以指定多个 /ue 选项。你不能同时使用此选项和 /all 选项。<DomainName> 和 <UserName> 可以包含星号 (*) 通配符。在指定包含空格的用户名时，必须在用户名两边加上引号。 例如： scanstate /i:migdocs.xml /i:migapp.xml \\server\share\migration\mystore /ue:contoso\user1

如何使用 /ui 和 /ue

以下示例适用于 /ui 和 /ue 选项。可以将 /ue 选项替换为 /ui 选项，以包含（而非排除）指定的用户。

同时使用各个选项

可以一起使用 /uel、/ue 和 /ui 选项，以仅迁移你想迁移的用户。

**/ui 选项优先于 /ue 和 /uel 选项。**如果使用 /ui 选项指定要包含某个用户，但又使用 /ue 或 /uel 选项排除该用户，则该用户将包含在迁移中。例如，如果指定 /ui:contoso\* /ue:contoso\user1，则将迁移 User1，因为 /ui 选项优先于 /ue 选项。

**/uel 选项优先于 /ue 选项。**如果某个用户在 /uel 选项设置的指定时间内登录，则将迁移该用户的配置文件，即使使用 /ue 选项排除了该用户。例如，如果指定 /ue:fixed\user1 /uel:14，则将迁移在过去 14 天登录该计算机的 User1。

加密文件选项

可以使用以下选项迁移加密文件。在所有情况以及默认情况下，如果发现加密文件，USMT 都会失败（除非指定 /efs 选项）。为迁移加密文件，必须更改默认行为。

有关详细信息，请参阅迁移 EFS 文件和证书。

备注
在迁移到 Windows Vista、Windows 7、或 Windows 8 时，将自动迁移 EFS 证书。因此，应使用 ScanState 命令指定 /efs:copyraw 选项，从而迁移加密文件。

不兼容的命令行选项

下表指出哪个命令行选项与 ScanState 命令不兼容。如果特定选项组合的表项为空，则各个选项都是兼容的，你可以同时使用它们。X 符号表示相应选项不兼容。例如，不能将 /nocompress 选项与 /encrypt 选项一同使用。

备注
你必须通过 /encrypt 选项指定 /key 或 /keyfile 选项。

另请参阅

其他资源

XML 元素库