新式化网站品牌

项目
04/08/2023

重要

新式化工具和所有其他 PnP 组件均为开源工具，由一个活跃社区提供支持服务。没有来自 Microsoft 的官方支持渠道的开放源代码工具支持的 SLA 。

SharePoint 新式用户界面处理品牌的方式与经典 SharePoint 不同，尤其是前者直接忽略在新式用户界面中不兼容的自定义母版页或备用 CSS 配置。可以选择在新式化网站中保留这些配置，这样它们仍可适用于在经典用户界面中显示的页面。不过，更简洁的办法是切换回 OOB 母版页，并删除备用 CSS 配置。

在这些母版页和备用 CSS 设置旁边，您还可使用经典自定义主题。这些经典自定义主题适用于经典页面和新式页面，但更具前瞻性的模型是新的租户控制的 SharePoint 主题，显而易见，它也适用于经典页面和新式页面。

检测使用母版页或备用 CSS 的网站

如需确定哪些网站使用自定义母版页或备用 CSS 选项，建议方法是运行 SharePoint 新式化扫描程序。此工具可深入分析租户中的所有网站，并生成报告，为您提供有关仍包含不兼容母版页或备用 CSS 设置的网站的详细信息。根据扫描程序输出，可以修正这些网站。

还原到默认配置

下面的 PnP PowerShell 脚本展示了如何还原到默认配置：

$minimumVersion = New-Object System.Version("2.24.1803.0")
if (-not (Get-InstalledModule -Name SharePointPnPPowerShellOnline -MinimumVersion $minimumVersion -ErrorAction Ignore))
{
    Install-Module SharePointPnPPowerShellOnline -MinimumVersion $minimumVersion -Scope CurrentUser
}
Import-Module SharePointPnPPowerShellOnline -DisableNameChecking -MinimumVersion $minimumVersion

Connect-PnPOnline -Url "<your site url>"

# Set out-of-the-box master page
Set-PnPMasterPage -MasterPageSiteRelativeUrl _catalogs/masterpage/seattle.master -CustomMasterPageSiteRelativeUrl _catalogs/masterpage/seattle.master

# Remove the alternate CSS setting
$web = Get-PnPWeb -Includes AlternateCssUrl
$web.AlternateCssUrl = ""
$web.Context.ExecuteQuery()

注意

PnP PowerShell 是一种开放源代码解决方案，其中包含为其提供支持的活动社区。没有用于 Microsoft 开放源代码工具支持的 SLA。

使用租户控制的 SharePoint 主题

SharePoint 提供了一系列可供您使用的现成默认主题，但若要推广公司品牌，建议创建公司主题，并隐藏现成主题。完成此配置后，用户只能从已配置的公司 SharePoint 主题中选择，并且您能以编程方式在新式化过程中设置此类 SharePoint 主题。

添加公司 SharePoint 主题

下面是一个示例 PnP PowerShell 脚本，展示了如何添加公司 SharePoint 主题：

$minimumVersion = New-Object System.Version("2.24.1803.0")
if (-not (Get-InstalledModule -Name SharePointPnPPowerShellOnline -MinimumVersion $minimumVersion -ErrorAction Ignore))
{
    Install-Module SharePointPnPPowerShellOnline -MinimumVersion $minimumVersion -Scope CurrentUser
}
Import-Module SharePointPnPPowerShellOnline -DisableNameChecking -MinimumVersion $minimumVersion

Connect-PnPOnline -Url "<your tenant admin url>"

# Define your company theme colors
$themepalette = @{
      "themePrimary" = "#00ffff";
      "themeLighterAlt" = "#f3fcfc";
      "themeLighter" = "#daffff";
      "themeLight" = "#affefe";
      "themeTertiary" = "#76ffff";
      "themeSecondary" = "#39ffff";
      "themeDarkAlt" = "#00c4c4";
      "themeDark" = "#009090";
      "themeDarker" = "#005252";
      "neutralLighterAlt" = "#f8f8f8";
      "neutralLighter" = "#f4f4f4";
      "neutralLight" = "#eaeaea";
      "neutralQuaternaryAlt" = "#dadada";
      "neutralQuaternary" = "#d0d0d0";
      "neutralTertiaryAlt" = "#c8c8c8";
      "neutralTertiary" = "#a6a6a6";
      "neutralSecondaryAlt" = "#767676";
      "neutralSecondary" = "#666666";
      "neutralPrimary" = "#333";
      "neutralPrimaryAlt" = "#3c3c3c";
      "neutralDark" = "#212121";
      "black" = "#000000";
      "white" = "#fff";
      "primaryBackground" = "#fff";
      "primaryText" = "#333"
     }

# Add the company theme
Add-PnPTenantTheme -Identity "CustomCompanyTheme" -Palette $themepalette -IsInverted:$false

使用公司 SharePoint 主题

如需使用公司 SharePoint 主题，可以运行下面的脚本：

$minimumVersion = New-Object System.Version("2.24.1803.0")
if (-not (Get-InstalledModule -Name SharePointPnPPowerShellOnline -MinimumVersion $minimumVersion -ErrorAction Ignore))
{
    Install-Module SharePointPnPPowerShellOnline -MinimumVersion $minimumVersion -Scope CurrentUser
}
Import-Module SharePointPnPPowerShellOnline -DisableNameChecking -MinimumVersion $minimumVersion

Connect-PnPOnline -Url "<your site url>"

# Set the company theme
Set-PnPWebTheme -Theme "CustomCompanyTheme"