SharePoint Starter Kit v3升级指南：从v1/v2迁移到v3的完整方案-CSDN博客

SharePoint Starter Kit v3升级指南：从v1/v2迁移到v3的完整方案

【免费下载链接】sp-starter-kit Modern SharePoint Starter Kit - End-to-end showcase solution to get started with modern experiences. 项目地址: https://gitcode.com/gh_mirrors/sp/sp-starter-kit

SharePoint Starter Kit v3是一个全面的SharePoint Online解决方案，提供了众多SharePoint Framework (SPFx) Web部件、扩展和其他组件，以及基于PnP PowerShell的自动配置功能。本指南将帮助您从v1或v2版本顺利迁移到v3版本，体验最新的功能和改进。

为什么选择升级到v3？

SharePoint Starter Kit v3带来了多项重要改进，使其成为现代SharePoint开发的理想选择：

全面支持最新SPFx版本：所有解决方案已更新至SPFx 1.16.1，确保与最新的SharePoint Online功能兼容。
全新的用户体验设计：展示了SharePoint Online的最新UX设计和布局功能，包括全高垂直列、紧凑标题、巨型菜单和背景主题。
独立解决方案部署：支持Web部件、扩展和库的单独部署，使管理和更新更加灵活。
增强的Microsoft Graph集成：展示了Microsoft Graph API和Graph Toolkit (mgt-react 2.9.0)在SharePoint Online中的使用。
Teams选项卡开发支持：为适合的Web部件提供了Teams选项卡开发功能。

升级前的准备工作

在开始升级过程之前，请确保您的环境满足以下要求：

管理员权限：您需要是租户管理员才能部署此解决方案。如果需要，可以从Microsoft 365 Developer Program获取免费的开发人员租户。
英语租户：自动端到端配置仅适用于英语租户，所有解决方案和Web部件目前也仅提供英语版本。
Term Store管理员：将用于配置的租户管理员账户添加为Taxonomy Term Store管理员。
应用程序目录：在SharePoint管理中心的"应用程序"选项中创建租户"应用程序目录"。

注意：如果您的SharePoint租户是新创建的，或者您刚刚创建了SharePoint租户应用程序目录，建议等待24小时后再尝试配置此解决方案。

PnP PowerShell：确保安装了最新版本的PnP PowerShell（已在1.12.0版本验证）。
Microsoft Graph Toolkit：此项目将在应用程序目录中安装Microsoft Graph Toolkit for SPFx版本2.9.0。如果您已经安装了其他版本，需要先删除该包。

从v1升级到v3的步骤

目前没有直接从v1升级到v3的路径。如果您的租户中已经安装了v1，建议先移除v1，然后再安装v3。或者，您可以创建v3的自定义安装，但请注意，默认情况下，这将在租户范围内添加所有Web部件和扩展的重复项。

移除v1的步骤

从应用程序目录中删除v1的SPFx解决方案包。
删除v1创建的网站集、网站设计和其他租户级设置。
移除与v1相关的任何自定义主题和分类术语集。

从v2升级到v3的步骤

从v2升级到v3相对简单，只需安装SPFx解决方案的更新版本，而无需重新创建示例网站。

升级步骤

准备PowerShell环境

打开PowerShell，确保已安装最新版本的PnP PowerShell：
```
Install-Module -Name PnP.PowerShell
```
连接到您的租户

使用具有租户管理员权限的凭据连接到您的租户：
```
Connect-PnPOnline -Url https://[yourtenant].sharepoint.com
```
执行SPFx-only升级

导航到项目的provisioning文件夹，并执行以下命令：
```
Invoke-PnPTenantTemplate -Path .\starterkit-spfx-only.pnp
```
此命令将仅升级现有的SPFx解决方案到v3（SPFx版本1.16.1），而不会重新创建示例网站。

全新安装v3的步骤

如果您是第一次安装SharePoint Starter Kit，或者从v1升级并已删除旧版本，请按照以下步骤进行全新安装：

准备环境

确保您已满足升级前的准备工作中列出的所有要求。

连接到您的租户

Connect-PnPOnline https://[yourtenant].sharepoint.com

执行完整安装
```
Invoke-PnPTenantTemplate -Path .\starterkit.pnp
```
这将在您的租户中创建三个网站集：/sites/contosoportal（通信网站）、/sites/contosohr（团队网站）和/sites/contosomarketing（团队网站）。

自定义网站URL

如果您想自定义网站集URL，可以使用-Parameters参数：

Invoke-PnPTenantTemplate -Path starterkit.pnp -Parameters @{"PORTALURL"="/sites/yourportal"; "MARKETINGALIAS"="yourmarketing"; "HRALIAS"="yourhr" }

批准API权限

安装完成后，访问SharePoint管理中心的API管理页面，批准待处理的Graph API权限请求。

常见问题和解决方案

升级过程中遇到错误怎么办？

如果在升级过程中遇到错误，请参考常见SP Starter Kit配置结果获取其他建议和常见问题的解决方案。

如何修改网站层次结构？

网站层次结构由starterkit.pnp文件定义。如果您想修改此模板，需要修改./source/templates文件夹中的starterkit.xml文件，并重新打包为新的starterkit.pnp文件：

$kit = Read-PnPTenantTemplate -Path ..\source\templates\starterkit.xml
Save-PnPTenantTemplate -Template $kit -Out yourstarterkit.pnp

如何自定义公司名称、天气城市等参数？

您可以使用-Parameters参数覆盖某些设置：

Invoke-PnPTenantTemplate -Path .\starterkit.pnp -Parameters @{"Company"="Your Company Name";"SiteUrlPrefix"="YourCompany";"WeatherCity"="Stockholm"}

可用的参数包括：Company、SiteUrlPrefix、WeatherCity、StockSymbol、PORTALURL、MARKETINGALIAS和HRALIAS。

v3版本的新功能和改进

SharePoint Starter Kit v3引入了多项新功能和改进，使其成为构建现代SharePoint解决方案的理想起点：

改进的Web部件

v3包含多个改进的Web部件，如Banner、Followed Sites、Links、LOB Integration等，每个都有独立的代码库，便于定制和扩展。例如：

People Directory：使用人员搜索API显示人员列表，提供了更丰富的人员查找体验。
Personal Calendar：使用Microsoft Graph显示当前用户的即将到来的日历会议。
Weather Information：使用Yahoo Weather API获取天气预报信息。

SharePoint Framework扩展

v3提供了多种扩展，如Alert Notification、Collaboration Footer、Discuss Now等，增强了SharePoint的用户体验和功能：

Alert Notification：基于中心网站中的自定义列表信息，在页面的标题部分显示信息性或重要消息。
Collaboration Footer：显示使用分类服务配置的公司范围链接，包括存储在用户配置文件属性中的个性化链接。

共享库

v3引入了一个共享库，包含共享的本地化字符串，可由任何其他SPFx Web部件或扩展使用，提高了代码复用性和一致性。

总结

SharePoint Starter Kit v3提供了一个全面的解决方案，帮助您快速构建现代化的SharePoint Online体验。无论您是从v1还是v2升级，本指南都提供了清晰的步骤和最佳实践，确保您的升级过程顺利进行。

通过升级到v3，您将能够利用最新的SPFx功能、改进的用户体验设计和增强的Microsoft Graph集成，为您的组织创建更强大、更灵活的SharePoint解决方案。

如需了解更多信息，请参阅详细的SharePoint Online配置说明和其他文档和操作指南。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考