评估经典 SharePoint 页面

使用 Microsoft 365 评估工具的经典页面组件在 SharePoint Online 中发现经典 Wiki、Web 部件、发布、博客、ASPX 和 Delve 博客页面。

Wiki、Web 部件和发布页面会收到详细的 Web 部件清单、布局、主页和映射准备情况扩充。 已发现并记录博客、ASPX 和 Delve 博客页面，但它们不会收到相同的 Web 部件映射就绪情况分析。

评估可以选择从 Microsoft Graph 审核日志收集页面视图/创建/编辑活动。

在当前实现中，Delve 博客页面显示在 中classicpages.csv，但未包含在 ClassicPages 中，或和 中的classicwebsummaries.csvclassicsitesummaries.csv页面类型计数。

页面类型支持

页面类型 已发现 详细就绪情况 转换路由 建议的操作
WikiPage 是 是 默认SitePages库中符合条件的页面的代表页批处理工作流 选择代表性模式，创建草稿，并在扩展前进行验证。
WebPartPage 是 是 默认SitePages库中符合条件的页面的代表页批处理工作流 选择代表性模式，创建草稿，并在扩展前进行验证。
PublishingPage 是 是 高级 PnP 跨站点转换 生成发布积压工作并定义单独的目标、布局映射、元数据和验证过程。
BlogPage 是 否 到目标新式 Web 的高级 PnP 博客转换 不要使用映射百分比进行选择;查看页面并使用单独验证的过程。
ASPXPage 是 否 没有等效的评估驱动转换路由 通过特定于方案的计划替换或重新生成页面。
DelveBlogPage 是 否 存在旧版 PnP cmdlet 选项，但不属于此工作流 将其保存在自动波形之外，并单独查看旧方案。

在本指南中

工作流

  1. 查看要求。
  2. 运行评估。
  3. 解释结果并设置其优先级。
  4. 查看发布页面就绪情况（如果适用）。
  5. 使用 PnP PowerShell 转换所选页面。
  6. 验证转换后的页面。

参考

运行评估

在运行应用程序身份验证示例之前，请配置 应用程序证书。

microsoft365-assessment.exe start --mode Classic --classicinclude Pages `
  --authmode application `
  --tenant <tenant>.sharepoint.com `
  --applicationid <application-id> `
  --certpath "My|CurrentUser|<certificate-thumbprint>"

特定于页面的选项：

选项 用途
--exportwebpartproperties 将 Web 部件属性导出为 JSON。
--skipusageinformation 跳过审核日志使用情况收集。
--auditlogwindowdays 将审核时段设置为 1 到 180 天。 默认值为 14。
--skipuserinformation 省略用户信息，例如修改者。
--homepageonly 仅评估每个 Web 的主页。

有关身份验证、SharePoint 访问、审核权限、平台支持和敏感输出指南，请参阅 经典页面评估的要求。

输出

文件 内容
classicpages.csv 每个经典页面一行，包括页面类型、布局、主页标志、映射百分比和未映射的 Web 部件。
classicpagewebparts.csv 在经典页面上找到的每个 Web 部件一行。
classicwebpartunique.csv 评估中每个唯一 Web 部件类型一行。
classicpageauditusage.csv 运行审核收集时的页面查看/创建/编辑活动。
classicwebsummaries.csv Per-Web 页计数和就绪情况汇总。
classicsitesummaries.csv 每个网站集的页面计数和就绪情况汇总。
classicpublishingsitesummaries.csv 发布门户网站级摘要。

Power BI 模板包括 “页面” 报表选项卡和共享的“摘要/扫描概述”选项卡。

有关架构和联接密钥，请参阅 经典页面 CSV 参考。

了解映射结果

对于 Wiki、Web 部件和发布页面， MappingPercentage 测量每个 Web 部件是否在嵌入式映射模型中具有可用映射。 它不能保证转换后的页面将保留所有视觉对象或业务行为。

对于博客、ASPX 和 Delve 博客页面，不要将默认或空的 Web 部件就绪情况值解释为已完成的映射分析。

对于扩充页， WebPartCount=0 表示 MappingPercentage=100 未提取任何 Web 部件。 WebPartCount=0 和 MappingPercentage=0 可以指示页面扩充失败;查看该页面的评估日志。

InMappingFile 中的 classicwebpartunique.csv 仅指示映射文件中存在 Web 部件类型。 使用 IsMappable 中的 classicpagewebparts.csv 和每页映射百分比来确定是否找到了可用映射。

有关完整的解释工作流，请参阅 解释经典页面评估报告。

继续执行页面转换

使用评估输出选择页面并确定需要修正的 Web 部件。 较高的映射百分比有助于确定工作的优先级，但不会转换页面。

  1. 查看 classicpages.csv 和 classicpagewebparts.csv。
  2. 删除、替换或映射阻止 Web 部件。
  3. 从小代表性波开始。
  4. 使用 PnP PowerShell 转换所选页面。
  5. 在展开波形之前验证生成的新式页面。

有关完整的转换模型和高级映射选项，请参阅 将经典页面转换为新式页面。

其他开源文档

  • Last updated on