SharePoint Online：使用 PowerShell 创建网站设计和网站脚本

SharePoint Online 中的网站设计和网站脚本是什么？

网站设计和网站脚本是在 SharePoint Online 中创建网站模板的新方法。假设您想要创建具有特定主题的网站、应用徽标、设置区域设置、在网站中创建列表或库、添加用户、创建内容类型和列、在导航中添加-删除链接、触发流程、加入中心站点、添加-删除站点栏等 - 然后利用站点设计。最好的部分不仅适用于新站点，而且您还可以将站点设计应用到任何现有站点以部署工件并使其保持一致。还记得功能装订吗？您也可以在此处创建网站设计并将其注册到 SharePoint Online 网站模板（例如团队网站或通信网站）。

站点脚本是一个 JSON 文件，其中包含一组在应用站点设计时要执行的预定义操作定义。站点设计充当站点脚本的容器。您可以将一个或多个网站脚本附加到网站设计（一个网站脚本可以附加到多个网站设计！），当您应用该网站设计时，您将执行所有网站脚本中定义的操作，并且它们将按列出的顺序运行。请注意，网站设计实际上并不是附加到网站的网站模板，而是应用网站设计时执行的一组操作。因此，更改网站设计不会更改现有网站上的任何内容（直到您重新应用网站设计）。

如何在 SharePoint Online 中创建网站设计？

基本上，网站设计的创建工作如下：您使用 JSON 模板创建一个网站脚本，并包含要运行的所需操作，例如创建列表、应用主题等，然后将该脚本添加到租户。下一步是创建网站设计并将网站脚本添加到设计中。创建网站设计时，您必须将其与任何现代网站模板关联，例如团队网站或通信网站模板。就这样。准备就绪后，您可以将其应用到新网站或现有网站。这是我的示例网站设计和脚本：

#Define Sitescript JSON
$JSONScript = @"
{
  "$schema": "schema.json",
  "actions": [
    {
      "verb": "applyTheme",
      "themeName": "Corporate Theme"
    },
    {
      "verb": "setRegionalSettings",
      "timeZone": 24,
      "sortOrder": 25,
      "hourFormat": "12"
    },
    {
      "verb": "setSiteLogo",
      "url": "/Style Library/logo.jpg"
    },
    {
      "verb": "createSPList",
      "listName": "Work",
      "templateType": 101,
      "subactions": [
        {
          "verb": "setTitle",
          "title": "Work"
        }
      ]
    }
  ],
  "bindata": {},
  "version": 1
}
"@
 
#Set Parameters
$AdminCenterURL = "https://crescent-admin.sharepoint.com/"
 
#Connect to SharePoint Online
Connect-SPOService -Url $AdminCenterURL -Credential (Get-Credential)
 
#Add Site Script
$SiteScript = $JSONScript | Add-SPOSiteScript -Title "Crescent Site Script"
 
#Add Site Design
$WebTemplate = "64" #64 = Team Site, 68 = Communication Site, 1 = Team Site without Group
Add-SPOSiteDesign -Title "Crescent Site Template" -WebTemplate $WebTemplate -SiteScripts $SiteScript.ID -Description "Crescent Site Template"

在 SharePoint Online 中部署网站设计

1. 根据 Microsoft 站点设计架构参考创建所需操作的站点脚本 JSON 架构。您还可以使用此在线工具生成 JSON 架构 在线 JSON 设计器：https://www.sitedesigner.io/，您可以使用我上面的 JSON 设置主题、应用徽标、配置区域设置和创建文档库。
2. 使用上述 PowerShell 脚本创建站点脚本和站点设计。每个租户最多可以创建 100 个网站脚本和 100 个网站设计！

3. 现在，您可以将此网站设计用于新网站或将其应用于新网站或现有网站。以下是它在新网站上的工作方式：

   • 转到 SharePoint Online 站点 >> 单击“设置”>> 单击“应用站点模板”。

4. 您将看到下拉列表中列出的自定义网站设计。就我而言，它是“新月网站模板”。

   

5. 单击“使用模板”按钮触发站点创建。创建站点后，您将看到正在应用站点脚本中定义的操作。

   

脚本中的操作完成后，SharePoint 将在进度窗格中显示这些操作的详细结果。更多用于管理 SharePoint Online 中的网站脚本和网站设计的 PowerShell cmdlet：

• Get-SPOSiteDesign - 检索在租户中创建的所有站点设计
• Get-SPOSiteScript - 获取可用站点脚本的列表
• Set-SPOSiteDesign - 更新现有站点设计
• Set-SPOSiteScript - 更新站点脚本 JSON
• Remove-SPOSiteScript - 删除给定的站点脚本
• 删除-SPOSiteDesign - 删除给定的网站设计 ID
• Invoke-SPOSiteDesign - 在现有站点上应用站点设计
• Grant-SPOSiteDesignRights - 设置使用网站设计的权限
• Revoke-SPOSiteDesignRights - 删除网站设计权限

以下是一些示例：

获取现有网站脚本和网站设计：

Get-SPOSiteScript

Get-SPOSiteDesign

更新现有网站脚本：

$SiteScriptId = "e694f7f2-ed9b-48ca-abe4-fb4fedc33c31"
$SiteScriptFile = "c:\Temp\sitescript.json"
Set-SPOSiteScript -Identity $SiteScriptId -Content (Get-Content $SiteScriptFile -Raw)

更新现有网站设计：

$SiteDesignId = "4d086b5b-c7a5-4b60-a3c5-e572ff0a6b8d"
Set-SPOSiteDesign -Identity $SiteDesignId -SiteScripts "d4708c15-949c-491f-8503-cd2a67a1de66", "36f5796f-dee2-4983-80af-a08d2951df86"

在现有网站上应用网站设计：

#Set Parameters
$AdminCenterURL = "https://crescent-admin.sharepoint.com/"
$SiteURL = "https://crescent.sharepoint.com/sites/marketing"
$SiteDesignId = "4d086b5b-c7a5-4b60-a3c5-e572ff0a6b8d"

#Connect to SharePoint Online
Connect-SPOService -Url $AdminCenterURL -Credential (Get-Credential)

#Apply Site Design
Invoke-SPOSiteDesign -Identity $SiteDesignId -WebUrl $SiteURL

将网站设计设置为默认：

Set-SPOSiteDesign -Identity $SiteDesignId -IsDefault:$True

删除现有网站脚本和网站设计：

Remove-SPOSiteDesign -Identity "f6611c71-dba5-4a32-8811-51472b7e5961"
Remove-SPOSiteScript -Identity "b2ac88ee-2711-4cbc-bea9-bf63e22af735"

结论

总之，在 SharePoint Online 中创建网站设计和网站脚本是自动创建自定义网站并确保整个组织的 SharePoint 环境的一致性的强大方法。网站设计允许您定义创建新网站时将执行的一组操作，例如添加列表、页面和 Web 部件。站点脚本允许您定义新站点的结构和内容，例如创建列表、库和页面。通过执行这些步骤，您可以轻松创建自定义网站设计和网站脚本，用于在 SharePoint Online 中创建具有所需结构和内容的新网站。