Add-SPOTheme

Ссылка

Модуль:: Microsoft.Online.SharePoint.PowerShell

Применяется к:: SharePoint Online

Создает новую пользовательскую тему или перезаписывает существующую тему, чтобы изменить ее параметры.

Синтаксис

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

Описание

Командлет Add-SPOTheme создает новую тему или обновляет существующую тему. Параметры цветовой палитры можно передать как хэш-таблицу или словарь.

Добавление темы не применяет ее к сайтам. Она добавляет тему в хранилище клиента, а затем она будет доступна в списке тем в разделе Изменить внешний вид для современных страниц.

Примеры

Пример 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 за декабрь 2017 г. командлет Add-SPOTheme требовал, чтобы параметры цветовой палитры передавались в виде словаря. Рекомендуется использовать последнюю версию командной консоли SPO или использовать функцию HashToDictionary для преобразования хэш-таблицы в словарь при необходимости.

Пример 2

Если вы хотите обновить существующую тему (например, чтобы изменить некоторые ее параметры цвета), используйте тот же синтаксис, что и ранее, но добавьте -Overwrite флаг в командлет Add-SPOTheme .

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