Add-SPOTheme

參考

模組:: Microsoft.Online.SharePoint.PowerShell

適用於:: SharePoint Online

建立新的自訂主題，或覆寫現有的主題以修改其設定。

Syntax

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

Description

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

注意事項

在 2017 年 12 月發行的 SPO 管理命令介面之前， Add-SPOTheme Cmdlet 需要將調色盤設定當做字典傳遞。建議您使用最新版的 SPO 管理命令介面，或視需要使用 HashToDictionary 函式將雜湊表轉換成字典。

範例 2

如果您想要更新現有的主題 (以修改其部分色彩設定，例如) ，請使用先前所示的相同語法，但將旗標新 -Overwrite 增至 Add-SPOTheme Cmdlet。

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

參數

-Identity

指定主題的名稱。這必須唯一識別主題。

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

-IsInverted

指定主題是否反轉，具有深色背景和淺色前景。

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

-Overwrite

覆寫相同名稱的主題，以防其存在。

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

-Palette

指定主題中色彩的調色盤，做為主題位置值的字典。

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