自定义 USMT XML 文件

概述

若要通过 ScanState 和 LoadState 工具使用任何迁移 .xml 文件，请使用 /i 选项在命令行中指定这些文件。 由于 ScanState 和 LoadState 工具需要 .xml 文件来控制迁移，因此为 ScanState.exe 和 LoadState.exe 命令指定同一组 .xml 文件。 但是， Config.xml 无需指定具有 /config 选项的文件，除非需要排除存储区中的某些已迁移文件和设置。 例如，将 Documents 文件夹迁移到存储，但不迁移到目标计算机。 若要实现此方案，请修改 文件， Config.xml 并使用 LoadState.exe 命令指定更新的文件。 然后，该 LoadState.exe 命令仅迁移所需的文件和设置。

如果 命令 中排除 LoadState.exe 了.xml文件，则会迁移存储区中缺少 的.xml 文件的所有数据。 但是，使用 ScanState.exe 命令指定的迁移规则不适用。 例如，如果 .xml 文件被排除在外，并且它包含重新路由规则，例如：

MigsysHelperFunction.RelativeMove("c:\data", "%CSIDL_PERSONAL%")

USMT 不会重新路由文件，它们会迁移到 C:\data。

若要修改迁移，请执行以下一项或多项操作。

  • 修改迁移 .xml 文件。 若要排除组件的一部分，请修改 .xml 文件。 例如，迁移 C：\ 但排除所有 .mp3 文件，或将数据移动到目标计算机上的新位置。 若要修改这些文件，必须熟悉迁移规则和语法。 要 使 ScanState 和 LoadState 使用这些文件，请在输入每个命令时在命令行中指定这些文件。

  • 创建自定义 .xml 文件。 还可以创建自定义 .xml 文件来迁移其他应用程序的设置，或更改迁移行为以满足组织的需求。 若要 使 ScanState 和 LoadState 使用此文件，请在两个命令行上指定它们。

  • 创建和修改 Config.xml 文件。 创建和修改 Config.xml 文件以从迁移中排除整个组件。 例如， Config.xml 文件可用于排除整个 Documents 文件夹，或排除应用程序的设置。 使用 Config.xml 文件排除组件比修改迁移 .xml 文件更容易，因为不需要熟悉迁移规则和语法。 此外，使用文件是排除操作系统设置迁移的唯一 Config.xml 方法。

有关排除数据的详细信息，请参阅 排除文件和设置 一文。

迁移 .xml 文件

本部分介绍 USMT 随附 的迁移.xml 文件。 每个文件都包含迁移规则，这些规则控制要将哪些组件迁移到目标计算机上的位置。

注意

可以在其中每个文件中使用星号 (*) 通配符。 但是，问号 ( ) 不能用作通配符。

  • MigApp.xml 文件。 使用 ScanState.exe 和 LoadState.exe 命令指定此文件以迁移应用程序设置。

  • MigDocs.xml 文件。 使用 ScanState 和 LoadState 工具指定此文件，以迁移 MigXmlHelper.GenerateDocPatterns 帮助程序函数找到的所有用户文件夹和文件。 此帮助程序函数查找驻留在任何驱动器根目录和用户目录中的用户数据。 但是，它不会在 Windows 目录中查找和迁移任何应用程序数据、程序文件或任何文件。 MigDocs.xml可以修改文件。

  • MigUser.xml 文件。 使用 ScanState.exe 和 LoadState.exe 命令指定此文件以迁移用户文件夹、文件和文件类型。 MigUser.xml可以修改文件。 此文件不包含迁移特定用户帐户的规则。 指定要迁移的用户帐户的唯一方法是使用 ScanState 用户选项和 LoadState 用户选项在命令行上。

注意

不要将 MigUser.xml 和 MigDocs.xml 文件一起使用。 有关详细信息，请参阅 标识文件类型、文件和文件夹 和 USMT 最佳做法 一文。

自定义 .xml 文件

可以创建自定义 .xml 文件，以针对组织的独特需求自定义迁移。 例如，可以创建自定义 .xml 文件来迁移业务线应用程序或修改默认迁移行为。 对于 ScanState.exe 和 LoadState.exe 若要使用此文件，请使用这两个命令指定该文件。 有关详细信息，请参阅 自定义 XML 示例 一文。

Config.xml 文件

文件 Config.xml 是一个可选文件，使用 /genconfig 选项和 ScanState.exe 命令创建。 应创建并修改此文件，以便从迁移中排除某些组件。 此外，必须创建和修改此文件，以排除迁移任何操作系统设置。 文件格式 Config.xml 不同于迁移 .xml 文件，因为它不包含任何迁移规则。 它仅包含可迁移的操作系统组件、应用程序和用户文档的列表。 有关示例，请参阅 Config.xml 文件一 文。 因此，使用 Config.xml 文件排除组件比修改迁移 .xml 文件更容易。 使用 时 Config.xml，不熟悉迁移规则和语法。 但是，不能在 Config.xml 文件中使用通配符。

若要包含所有默认组件， Config.xml 无需创建文件。 或者，如果 、 和 文件中定义MigApp.xml的默认迁移行为令人满意，并且只需要排除某些组件，则可以创建文件Config.xml。MigUser.xmlMigDocs.xml 其他 .xml 文件可以保留其原始状态。

使用 选项运行命令时，ScanState.exe读取使用 /i 选项指定的其他 .xml 文件，以创建可从计算机迁移的组件自定义列表。/genconfigScanState.exe 此文件仅包含操作系统组件、应用程序和用户文档部分，它们位于两个.xml 文件中，并在使用 选项运行/genconfig命令时ScanState.exe安装在计算机上。 因此，应在包含目标计算机上存在的所有组件、应用程序和设置的源计算机上创建此文件。 在源计算机上创建文件可确保此文件包含可以迁移的每个组件。 这些组件分为多个部分： <应用程序>、 <WindowsComponents> 和 <文档>。 若要选择不迁移组件，请将其条目更改为 migrate="no"。

创建此文件后，只需使用 /Config 选项使用 ScanState.exe 命令指定它即可影响迁移。 但是，如果需要排除迁移到存储区的其他数据，请修改文件并使用 Config.xml 命令指定更新的文件 LoadState.exe 。 例如，如果在存储中收集了 Documents 文件夹，但“文档”文件夹不需要迁移到目标计算机，Config.xml则可以在命令运行之前LoadState.exe修改该文件以指示migrate="no"该文件，并且不会迁移该文件。 有关排除数据时发生的优先级的详细信息，请参阅 排除文件和设置 一文。

此外，请注意文件中的以下功能 Config.xml ：

  • 如果通过指定 migrate="no"从文件中的迁移Config.xml中删除父组件，则其所有子组件都会从迁移中自动删除，即使子组件设置为 migrate="yes"也是如此。

  • 如果错误地为同一组件存在两行代码，其中一行指定 migrate="no" ，另一行指定 migrate="yes"，则会迁移组件。

  • 在 USMT 中，可以在 文件中配置 Config.xml 多个迁移策略。 例如，可以配置其他 <ErrorControl>、 <ProfileControl> 和 <HardLinkStoreControl> 选项。 有关详细信息，请参阅 Config.xml 文件一 文。

注意

若要从Config.xml文件中排除组件，请将迁移值设置为“no”。 从 Config.xml 文件中删除组件的 XML 标记不会从迁移中排除组件。

示例

  • 以下命令在当前目录中创建文件 Config.xml ，但不创建存储：

    ScanState.exe /i:MigApp.xml /i:MigDocs.xml /genconfig:Config.xml /v:5

  • 以下命令使用 Config.xml 文件和默认迁移 .xml 文件创建加密存储：

    ScanState.exe \\server\share\migration\mystore /i:MigApp.xml /i:MigDocs.xml /o /config:Config.xml /v:5 /encrypt /key:"mykey"

  • 以下命令解密存储并迁移文件和设置：

    LoadState.exe \\server\share\migration\mystore /i:MigApp.xml /i:MigDocs.xml /v:5 /decrypt /key:"mykey"

其他信息