SharePoint 迁移工具设置SharePoint Migration Tool Settings

下表详细列出了 SPMT 中可用的设置。高级设置仅应由 IT 专业人员进行更改或管理。The following table details the settings available in SPMT. Advanced settings should only be changed or managed by your IT professional.

常规General

设置Setting 说明Description
仅执行扫描Only perform scanning 如果要扫描文件作为迁移的预评估,请设置为“”。If you wish to scan the files as a pre-assessment to migration, set to On.
如果未发现扫描问题,则自动开始迁移Start migration automatically if no scan issue found 如果设置为“”,则在未发生扫描问题的情况下自动开始迁移。If set to On, migration will start automatically if no scan issues are found.
保留 SharePoint 权限Preserve SharePoint permissions 如果设置为“”,则将迁移源 SharePoint 文件、文件夹和项目上的权限。If set to On, permissions on your source SharePoint files, folders, and items will be migrated.
保留权限继承Preserve permissions inheritance 保留权限继承。Preserve permissions inheritance.
保留文件共享权限。Preserve file share permissions. 保留已迁移文件上的权限。Preserve permissions on the files migrated.

用户Users

设置Setting 说明Description
Azure Active Directory 查找Azure Active Directory lookup 此项默认设置为“”。如果用户未提供用户映射文件,则默认使用 Active Directory 进行用户映射。By default, this is set to On. If no user mapping file is provided by the user, then Azure Active Directory is used as the default for user mapping.
自动的用户映射Automatic user mapping 用户映射将自动完成。User mapping will be done automatically.
用户映射文件User mapping file 默认情况下, Azure AD 查找 用于在提交迁移作业时映射用户。By default, Azure AD lookup is used to map users when submitting migration jobs. 如果想要使用自己的映射文件,请选择“选择文件”,选择要使用的文件。If you want to use your own mapping file, select the file to be used by selecting Choose file. 如果选择使用自定义用户映射文件,并且想要保留用户权限,请关闭“Azure Active Directory 查找”。If you choose to use a custom user mapping file and want to preserve user permissions, turn off Azure Active Directory lookup. 这样做后,如果未在映射文件中找到用户,则该工具不会在 Azure AD 中查找。By doing so, if a user isn't found in the mapping file, the tool won't look it up in Azure AD.

筛选器Filters

设置Setting 说明Description
迁移文件版本历史记录Migrate file version history 如果设置为“关”,将仅迁移最新版本的文件。如果设置为“开”,可选择是保留所有版本还是限于特定版本。If set to Off, only the most recent version of the file will be migrated. If set to On, you can choose whether to keep all versions, or limit it to a specific number.
保留所有版本Keep all versions 如果设置为“”,则将迁移文件的所有版本。If set to On, all versions of a file will be migrated.
要迁移的版本数Number of versions to migrate 输入一个数字,用于限制所迁移的文件版本数。Enter a number to limit the number of file versions migrated.
包含隐藏文件Include hidden files 如果设置为“”,则 迁移隐藏的系统文件。If set to Off, hidden system files will not be migrated.
迁移之后创建的文件Migrate files created after 仅迁移选定日期后创建的文件。Only migrate files created after the selected date. 此设置可用于限制迁移的文件数量或遵守公司关于文件保留的整体治理策略。This setting may be used to limit the number of files migrated or to adhere to overall company governance policy regarding file retention.
迁移之后修改的文件Migrate files modified after 仅迁移在所选日期后修改的文件。Only migrate files modified after the selected date. 此设置可用于限制迁移的文件数量或遵守公司关于文件保留的整体治理策略。This setting may be used to limit the number of files migrated or to adhere to overall company governance policy regarding file retention.
不迁移具有这些扩展名的文件Do not migrate files with these extensions 输入一个列表,其中包含你不想迁移的文件类型的文件扩展。Enter a list of file extensions of file types you do not want to migrate. 用冒号分隔所输入的每个扩展名。Separate each extension entered with a colon. 不包含点。Do not include the dot. 例如,将 .txt 输入为 txtFor example, .txt is entered as txt.
注意 具有多个文件扩展名的文件如*.ext1.ext2,仅将最后一个扩展名 .ext2 添加到排除列表中。Note For files with multiple file extensions, for example *.ext1.ext2, add only the last extension, .ext2, to the exclusion list.
将 OneNote 文件夹迁移为 OneNote 笔记本Migrate OneNote folder as OneNote notebook
此项默认设置为“”。By default, this is set to Off. 如果设置为为“”,OneNote 文件夹将作为含有文件的普通文件夹迁移,而不是作为 OneNote 笔记本迁移。When set to Off, OneNote folders will migrate over as a regular folder with files, and not as a OneNote Notebook. 如果设置为 ,它们将作为 OneNote 笔记本迁移。If set to On, they will migrate as OneNote Notebooks. 目前,已禁用在 SharePoint 本地迁移笔记本的功能。At this time, the ability to migrate notebooks on SharePoint on-premises is disabled. 注意 自版本 3.4.121.2 起已弃用此设置。NOTE This setting has been deprecated starting in Version 3.4.121.2.
替换无效的文件名字符Replace invalid filename characters 如果设置为“启用”,则文件名中找到的任何无效字符都将替换为框中提供的单个有效字符。If set to On, any invalid character found in a filename will be replaced with the single valid character you have provided in the box. 无效字符包括 *"<>:/'。Invalid characters include *"<>:/'. 对于完整的列表,请参阅 OneDrive 和 SharePoint 中的无效文件名和文件类型For a complete list, see: Invalid file names and file types in OneDrive and SharePoint.

如果设置为“关闭”,则该工具将跳过名称包含无效字符的文件。If set to Off, the tool will skip files whose name includes invalid characters. 虽然当源文件可能包含大量含有无效字符的文件时,将此设置为关闭可以提高性能,但这样也有缺点。While having this set to off can improve performance when the source potentially contains a high number of files containing invalid characters, it also has drawbacks. 为了防止恶意活动,将会阻止向目标服务器生成超过 100 个错误的源包。To prevent malicious activities, source packages that generate more than 100 errors to the destination server will be blocked. 因此,该包中的所有有效文件也将被阻止。As a result, all valid files in that package would also be blocked.
筛选子网Filter subsites 输入要从迁移中排除的所有子网名称。Enter any subsite names you want to exclude from migration.
筛选列表和库Filter lists and libraries 输入要从迁移中排除的列表和库的名称。Enter the names of the lists and libraries you want to exclude from migration.
筛选内容类型Filter content type 输入要从迁移中排除的内容类型。Enter the content types you want to exclude from migration.

SharePointSharePoint

设置Setting 说明Description
迁移网站设置Migrate site settings 此设置仅在当所选的源为 所有列表、库、页面和 web 部件 时才可用。This setting is available only when the source selected is all lists, libraries, pages, and web parts. 有四个可用选项:Four options are available:
保留所有设置:迁移所有支持的网站级别设置,包括标题、徽标、功能、审核设置等。Preserve all settings: Migrate all site level settings supported, including title, logo, features, audit settings, and others.
忽略标题和徽标: 将跳过标题和徽标,但将迁移所有其他网站设置。Skip title and logo: Title and logo are skipped, but all other site settings will be migrated.
仅标题和徽标: 仅迁移标题和徽标。Only title and logo: Only the title and logo will migrate.
忽略所有设置: 不会迁移任何网站级别设置。Skip all settings: No site level settings will be migrated.
跳过启用受众目标的列表Skip list with audience targeting enabled 选择是否要迁移已启用受众目标的 SharePoint Server 列表。Choose if you want to migrate SharePoint Server lists with audience targeted enabled.
迁移所有网站域 和内容类型Migrate all site fields and content types 选择是否要迁移网站域(即使迁移不需要这些域)。Choose if you want to migrate sites fields even if they aren't required for migration.
迁移托管的元数据Migrate managed metadata 选择是否要迁移正在网站上使用的所有托管元数据术语。Choose if you want to migrate all managed metadata terms that are in use on the site.
迁移 Web 部件和网页Migration of web parts and pages 选择在目标中已存在页面和 Web 部件时如何处理迁移。Choose how to handle migration if the pages and web parts already exist in the destination.
选择下列中的一个:覆盖重复项重命名重复项跳过重复项,或者 不迁移Select one: Overwrite duplicate, Rename duplicate, Skip duplicate, or Do not migrate.
暂时允许迁移脚本Temporarily allow migration of scripts 此设置将自动允许迁移已编写脚本 web 部件。This setting will automatically allow the migration of scripted web parts.
迁移网站导航Migrate site navigation 迁移 SharePoint 中网站或网页的导航链接。Migrate the navigation links of a site or page in SharePoint.
迁移带有查阅列的列表Migrate lists with lookup columns 此设置控制在查阅列中所引用的全部列表的迁移行为。This setting controls the behavior of migrating all lists referenced in lookup columns. 选项包括:迁移在查找列中所引用的全部列表忽略迁移列表中的查找列,以及 仅针对含查阅列的任何列表的报告错误。不迁移。Options include: Migrate all lists referenced in lookup columns, Ignore lookup columns in migrated lists, and Only report error for any list with a lookup column. Do not migrate. 此设置仅在任务中选择的源为列表时才可用。This setting is only available if the source selected in a task is a list. 如果您要进行网站迁移,则SPMT将自动迁移所有引用的列表,因此该设置不会对用户显示。If you are doing a site migration, SPMT will automatically migrate all referred lists, so this setting will not appear to the user.

高级Advanced

设置Setting 说明Description
迁移自动重新运行Migration auto rerun 选择是否要自动重新运行迁移任务以查找更改或添加。Choose if you want to automatically rerun a migration task to look for changes or additions. 选择 运行一次,或者 连续运行5次Select either Run once, or Run up to 5 successive times.
SharePoint 迁移工具工作文件夹SharePoint Migration Tool working folder
选择是否要创建自己的工作文件夹。Choose if you want to create your own working folder. 默认将创建一个临时文件夹。By default, a temp folder will be created.
注意: 默认情况下,工作文件夹是 %appdata%\Microsoft\MigrationToolNote: By default, the working folder is %appdata%\Microsoft\MigrationTool. 请确保工作文件夹拥有至少 150 GB 的可用空间。Make sure that your working folder has a minimum of 150 GB of free space. 可能需要更大的可用空间,具体取决于计划迁移的数据规模。It may need more depending on the size of the data you plan to migrate.

自定义 Azure 存储Custom Azure Storage

重要

成本:Cost:
如果选择使用 Azure 存储,请注意这可能会产生带宽费用。If you choose to use your Azure Storage, be aware that you could incur bandwidth charges. 将根据 Azure 产品/服务类型和迁移规模进行计费。Those will be billed depending on your Azure offer type and migration size. 对于一般价格,请参阅带宽定价For general prices, see Bandwidth pricing.

设置Setting 说明Description
使用自定义 Azure 存储Use custom Azure Storage 如果希望使用自己的 Azure 存储,请将此值设置为“”。If you wish to use your own Azure Storage, set this value to On. 输入帐户和密钥。Enter your account and key. 选择是否要启用加密功能,以及是否要在迁移完成后删除临时工作文件。Select if you want to enable encryption, and if you want temporary working files to be deleted when migration is complete.

备注

仅常规用途存储帐户 才支持此功能,因为常规用途存储帐户支持 Azure Blob 和队列。This feature is supported only for General Purpose storage accounts as General Purpose accounts support Azure blobs and queues. 此功能在 Blob 存储帐户中不可用。This feature is not available for Blob Storage accounts.

SharePoint 迁移工具反馈和支持论坛SharePoint Migration Tool Feedback and Support Forum