Add-SPOTheme

创建新的自定义主题,或覆盖现有主题以修改其设置。

语法

Add-SPOTheme
   -Identity <SpoThemePipeBind>
   -IsInverted <bool>
   -Overwrite
   -Palette <SpoThemePalettePipeBind> 
   [<CommonParameters>]

说明

Add-SPOTheme cmdlet 创建新主题或更新现有主题。 调色板设置可以作为哈希表或字典传递。

添加主题不会将主题应用于任何网站。 它将主题添加到租户存储,然后主题在“更改新式页面 的外观 ”选项下的主题列表中可用。

示例

示例 1

在此示例中,将创建一个名为 "Custom Cyan" “新主题”的新主题,其中的调色板设置是各种青色色调。 请注意,设置作为哈希表传递。

$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-SPOTheme -Identity "Custom Cyan" -Palette $themepalette -IsInverted $false

备注

在 SPO Management Shell 2017 年 12 月发布之前, Add-SPOTheme cmdlet 要求将调色板设置作为字典传递。 建议使用最新版本的 SPO Management Shell,或根据需要使用该 HashToDictionary 函数将哈希表转换为字典。

示例 2

若要更新现有主题 (以修改其某些颜色设置(例如) ),请使用与之前所示相同的语法,但将标志添加 -OverwriteAdd-SPOTheme cmdlet。

Add-SPOTheme -Identity "Custom Cyan" -Palette $themepalette -IsInverted $false -Overwrite

参数

-Identity

指定主题的名称。 这必须唯一标识主题。

Type:SpoThemePalettePipeBind
Aliases:Name
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-IsInverted

指定主题是否反转,背景为深色,前景为浅色。

Type:Boolean
Aliases:None
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-Overwrite

如果存在同一名称,则覆盖该主题。

Type:SwitchParameter
Aliases:None
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-Palette

将主题中的颜色调色板指定为主题槽值的字典。

Type:SpoThemePalettePipeBind
Aliases:None
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online