SharePoint 迁移评估工具概述

  • 项目

SharePoint 迁移评估工具是一个简单的命令行可执行工具。 它会扫描 SharePoint 场的内容，以帮助确定使用 Microsoft 365 将服务器迁移到 SharePoint 的影响。

该工具设计为在不影响环境的情况下运行，因此你可能会发现该工具需要一到两天才能完成环境扫描。 在此期间，该工具在控制台窗口中报告进度。 扫描完成后，输出文件将位于 Logs 目录中。 可在此处找到有关可能受迁移影响的方案的摘要和更详细的见解。

注意

若要下载 SharePoint 迁移评估工具，请参阅 下载 SharePoint 迁移评估工具。

注意

为了提高 Microsoft 产品和服务的质量，该工具向 Microsoft 报告匿名统计信息。 （可选）可以在扫描结束时出现提示时标识组织。 如果该工具无法连接到 Internet 来报告此信息，该工具仍按预期运行。

先决条件

该工具构建为在 SharePoint 2010、2013 或 2016 场中运行，并具有以下先决条件：

  • 若要运行该工具，必须在执行之前从任何压缩包中提取所有文件。

  • 该工具必须作为场服务帐户运行。 只要已向该帐户授予对所有 Web 应用程序的读取权限，服务器场管理员帐户就可接受。 该帐户还需要对 操作>管理员 的显式完全控制权限和对用户配置文件服务应用程序的 共享>权限 。 需要进行一系列检查，以确保帐户在扫描环境之前具有足够的权限。

  • 该工具仅支持 SharePoint 的英语版本。

配置文件

可以修改 SMAT 的两个配置文件：

  • SiteSkipList.csv 安装在与 SMAT.exe 相同的目录中。 将站点添加到此 CSV 会告知 SMAT 不要在报表输出中包含这些站点。 有关如何将网站添加到跳过列表的示例，请参阅 SiteSkipList.csv。

  • ScanDef.json 安装在与 SMAT 相同的目录中。 可以使用ScanDef.json为 SMAT 启用或禁用单个扫描。 此文件包含 SharePoint 2010 和 2013 上的评估配置。

若要禁用扫描，请在 ScanDef.json 文件中找到条目，并将 “启用” 设置为 false。 如果存在业务不关心的扫描，这很有用。 禁用扫描可缩短 SMAT 的总体执行时间。

下面将禁用警报扫描。

{ "Name": "Alerts", "Type": "AlertsScanner", "SupportedVersions": [ "2010", "2013", "2016" ], "ReportCategoryType": "SPSite", "Enabled": false }

SupportedVersion 告知 SMAT 特定扫描适用于哪些 SharePoint 版本。 例如，SharePoint 2010 没有 SharePoint 加载项，因此应用扫描程序不会将 2010 列为受支持的版本。

{ "Name": "Apps", "Type": "AppsScanner", "SupportedVersions": [ "2013", "2016" ], "ReportCategoryType": "SPSite", "Enabled": true }

某些扫描具有其他配置选项。 这些在 ScanDef.json 文件中可配置。 并非所有扫描都具有可配置的属性。 但是，如果扫描具有 属性，则会在 ScanDef.json 文件中配置一个可修改的默认属性。 例如， SiteTemplateLanguage 扫描具有用于排除英语网站 [区域设置 1033] 的筛选器。 如果你的团队对迁移英语网站有疑问，你可以修改筛选器以包括这些网站：

{ "Name": "SiteTemplateLanguage", "Type": "SiteTemplateLanguageScanner", "SupportedVersions": [ "2010", "2013", "2016" ], "Property": { "ExcludedLanguages": "" }, "ReportCategoryType": "SPSite", "Enabled": true }

如果删除或损坏ScanDef.json文件，将改用嵌入 SMAT.exe 可执行文件中的默认配置。 这在 SMAT.log 文件中进行了记录。 如果禁用扫描或更改属性，并注意到在运行 SMAT.exe 时未选取更改，请查看 SMAT.log 文件了解详细信息。

执行

从提取的文件位置运行 smat.exe。 若要查看所有可用参数，请运行： smat.exe /help。

SMAT.exe 是一个启动器程序，它根据传入的参数确定你的意图，然后加载相应的应用程序来执行请求的工作。 在后台，有三个可执行文件负责执行工作：

  • SMAT2010.exe - 对 SharePoint 2010 环境执行评估。

  • SMAT2013.exe - 对 SharePoint 2013 环境执行评估。

  • SMIT.exe - 为 SharePoint 2010 和 2013 环境执行标识映射工作。

注意

由于弃用 Azure AD Graph 服务，SMIT 在 2023 年 6 月 30 日之后停止运行。 有关最新公告的更多详细信息，请参阅 重要提示：Azure AD Graph 停用和 Powershell 模块弃用。 运行 SMAT.exe 以从 PowerShell.exe 执行评估时，将执行以下操作。 运行 SMAT.exe 的 PowerShell 窗口启动应用以执行工作。 加载工作应用后，SMAT.exe 加载程序程序终止，并将控制权返回给操作员。 执行工作的工具在其自己的窗口中运行，直到完成。

日志文件

输出目录中最多可能会看到三个日志文件：

  • SMAT.log - 此文件包含工具执行中的所有日志记录。 这包含三个级别的日志记录： 信息、 警告和 错误。 信息有助于跟踪进度并排查问题。 通常，警告是预期的错误条件。 错误是意外的情况，我们的工具无法确定它们是否会阻碍前进。 需要审查这些内容。

  • SMAT_Errors.log - 仅包含 Error 事件。 如果在工具完成后缺少此文件，则表示未找到任何错误。

  • SMATTelemetry.log - 包含遥测上传工具的日志记录。 此处的任何问题都不会影响生成报告。

自动评估

如果需要计划评估过程，可以通过运行特定的 .exe 文件来执行此操作。 例如，如果要在 SharePoint 2010 场上设置计划任务进行评估，可以将计划任务指向 SMAT2010.exe。 如果要编写在 SharePoint 2013 上运行评估的 PowerShell 脚本，可以将该脚本指向 SMAT2013.exe。

任何脚本方案都必须使用 -q 开关在安静模式下运行 .exe 文件。 此模式不会向控制台提供任何输出，并避免任何提示操作员输入的内容。

详细信息

若要下载 SharePoint 迁移工具，以及如何解决评估报告中发现的问题的详细信息，请参阅