将 PnP 模板应用于 SharePoint 网站

在此页中,可以找到有关如何在租户上手动预配外观书籍模板的详细信息。

还可以通过观看 Microsoft 365 平台社区 (PnP) YouTube 频道上的此视频来按照以下步骤操作:

软件先决条件

若要预配外观书籍模板,需要在计算机上安装以下软件工具:

安装上述工具后,可以继续执行以下部分。

注意

PnP 预配框架 & PnP 预配引擎是开放源代码解决方案,其活动社区为其提供支持。 没有用于 Microsoft 开放源代码工具支持的 SLA。

可用模板

外观书籍模板基于 PnP 预配引擎。 因此,每个模板都是一个 .pnp (pnp 代表模式 & 实践) 文件,它只不过是一个 OpenXML 文件,其中包含部署模板所需的所有内容。 下面是一个表格,你可以在其中找到所有外观书籍模板的列表,链接下载相应的 .pnp 模板文件、配置参数和先决条件。

类别 模板 网站类型 参数 先决条件
组织 领导力连接 通信网站
  • SiteTitle
  • SiteUrl
SharePoint Online 管理员
透视 通信网站
  • SiteTitle
  • SiteUrl
SharePoint Online 管理员
危机通信 通信网站
  • SiteTitle
  • SiteUrl
SharePoint Online 管理员
新闻网站 通信网站
  • SiteTitle
  • SiteUrl
SharePoint Online 管理员
登陆 通信网站
  • SiteTitle
  • SiteUrl
SharePoint Online 管理员
优势 通信网站
  • SiteTitle
  • SiteUrl
SharePoint Online 管理员
LGBTQ+ 员工资源组 通信网站
  • SiteTitle
  • SiteUrl
SharePoint Online 管理员
西班牙裔传统月员工资源组 通信网站
  • SiteTitle
  • SiteUrl
SharePoint Online 管理员
部门 零售运营 通信网站
  • SiteTitle
  • SiteUrl
SharePoint Online 管理员
飞行安全会议 通信网站
  • SiteTitle
  • SiteUrl
SharePoint Online 管理员
全球销售中心 通信网站
  • SiteTitle
  • SiteUrl
  • RetailOperationsSiteTitle
  • RetailOperationsSiteUrl
  • ConsumerRetailSiteTitle
  • ConsumerRetailSiteUrl
SharePoint Online 管理员
研讨会培训网站 通信网站
  • SiteTitle
  • SiteUrl
SharePoint Online 管理员
全球营销中心 通信网站
  • SiteTitle
  • SiteUrl
  • CommunicationSiteTitle
  • CommunicationSiteUrl
SharePoint Online 管理员
人力资源中心 通信网站
  • SiteTitle
  • SiteUrl
  • BenefitsSiteTitle
  • BenefitsSiteUrl
SharePoint Online 管理员
团队 协作团队网站 新式团队网站
  • SiteTitle
  • SiteAlias
SharePoint Online 管理员
团队通信网站 通信网站
  • SiteTitle
  • SiteUrl
SharePoint Online 管理员
Mark8 项目团队 通信网站
  • SiteTitle
  • SiteUrl
SharePoint Online 管理员
产品支持 通信网站
  • SiteTitle
  • SiteUrl
SharePoint Online 管理员
社区 品牌网站 通信网站
  • SiteTitle
  • SiteUrl
SharePoint Online 管理员
慈善网站 通信网站
  • SiteTitle
  • SiteUrl
SharePoint Online 管理员
解决方案 Microsoft 365 学习路径 通信网站
  • SiteUrl
SharePoint Online 管理员,应用程序目录
新员工部门入职网站 通信网站
  • SiteTitle
  • SiteUrl
SharePoint Online 管理员
工作区转换网站 通信网站
  • SiteUrl
SharePoint Online 管理员
新员工入职网站 通信网站
  • SiteTitle
  • SiteUrl
SharePoint Online 管理员
新员工公司入职网站 通信网站
  • SiteTitle
  • SiteUrl
SharePoint Online 管理员
Microsoft 365 自由职业者通信网站 通信网站
  • SiteUrl
SharePoint Online 管理员
SharePoint Success Site 通信网站
  • SiteUrl
SharePoint Online 管理员,应用程序目录
Schools 学校主页 通信网站
  • SiteTitle
  • SiteUrl
普通用户
教职员工主页 工作组网站
  • SiteUrl
普通用户
课堂主页 工作组网站
  • SiteUrl
普通用户

下面是有关参数的简要指南:

  • SiteTitle:是在目标网站上预配的标题。
  • SiteUrl:是模板预配的网站相对于服务器的 URL。 它可以类似于: /sites/name-of-the-site
  • RetailOperationsSiteTitle:是针对全球销售中心模板的目标租户预配的通信网站的标题。
  • RetailOperationsSiteUrl:是模板“全局销售中心”预配的零售运营通信网站的相对于服务器的 URL。 它可以类似于: /sites/name-of-the-site
  • ConsumerRetailSiteTitle:是针对全球销售中心模板的目标租户预配的零售运营通信网站的标题。
  • ConsumerRetailSiteUrl:是模板“全球销售中心”预配的消费者零售通信网站的相对于服务器的 URL。 它可以类似于: /sites/name-of-the-site
  • CommunicationSiteTitle:是针对全球营销中心模板的目标租户预配的消费者零售通信网站的标题。
  • CommunicationSiteUrl:是模板全球营销中心预配的通信网站的相对于服务器的 URL。 它可以类似于: /sites/name-of-the-site
  • BenefitsSiteTitle:是人力资源中心模板预配的通信网站的标题。
  • BenefitsSiteUrl:是人力资源中心模板预配的通信网站的相对于服务器的 URL。 它可以类似于: /sites/name-of-the-site

下面是有关先决条件含义的简要指导:

  • SharePoint Online 管理员:需要使用 SharePoint Online 管理员组成员的用户执行预配。
  • 应用程序目录:需要在目标租户中拥有一个功能齐全的租户范围应用程序目录,并且需要使用对应用程序目录网站具有管理员访问权限的用户执行预配。
  • 常规用户:可以使用 SharePoint Online 的常规用户执行预配。

注意:如果未在租户中配置应用程序目录,并且你愿意预配的模板需要应用程序目录,则可以按照此 联机文档中提供的说明进行操作。

预配模板

若要执行实际预配,需要执行 PnP PowerShell 扩展提供的 PowerShell cmdlet。

需要 SharePoint Online 管理员的预配模板

下载要预配的 .PNP 模板文件,将其保存在本地文件夹中,并运行以下 PowerShell 命令:

Connect-PnPOnline https://<tenant>.sharepoint.com/sites/<URL-of-your-target-site> -Interactive

Invoke-PnPTenantTemplate -Path .\your-template-file.pnp -Parameters @{"SiteTitle"="<Title-of-your-target-site>";"SiteUrl"="/sites/<URL-of-your-target-site>"}

将 tenant> 替换为 <Microsoft 365 中 SharePoint Online 租户的实际名称。 请记得为上表中声明的所有参数提供一个值。

重要提示:首次使用 Connect-PnPOnline 命令 let 连接到目标环境时,必须授予 一组对 PnP 命令行管理程序 应用程序的权限。

需要常规用户的预配模板

下载要预配的 .PNP 模板文件,将其保存在本地文件夹中,并运行以下 PowerShell 命令:

Connect-PnPOnline https://<tenant>.sharepoint.com/sites/<URL-of-your-target-site> -Interactive

Invoke-PnPSiteTemplate -Path .\your-template-file.pnp -Parameters @{"SiteTitle"="<Title-of-your-target-site>";"SiteUrl"="/sites/<URL-of-your-target-site>"}

将 tenant> 替换为 <Microsoft 365 中 SharePoint Online 租户的实际名称。 请记得为上表中声明的所有参数提供一个值。

用于应用 Learning Pathways 解决方案的示例脚本

这就是 PowerShell 脚本应用 Learning Pathways 解决方案的方式,该解决方案仅具有 SiteUrl 参数,而 Learning Pathways 的 pnp 文件位于 c:\temp 文件夹中,并且你希望以以前创建的 URL 为 /sites/M365LP 的网站为目标。

Connect-PnPOnline https://<tenant>.sharepoint.com/sites/<URL-of-your-target-site>

Invoke-PnPSiteTemplate -Path c:\temp\M365LP.pnp -Parameters @{"SiteUrl"="/sites/M365LP"}

后续步骤

在租户上预配了外观书籍模板后,可以随意浏览到所选网站 URL 并使用新网站。

如果有任何问题,请随时在 GitHub 上的 PnP 预配服务存储库中提交问题。