Add-SPOTheme
Создает новую пользовательскую тему или перезаписывает существующую тему, чтобы изменить ее параметры.
Синтаксис
NewThemeSet
Add-SPOTheme
[-Identity] <SpoThemePipeBind>
-ColorPairs <SpoThemeColorPairPipeBind>
[-Overwrite]
[<CommonParameters>]
LegacyThemeSet
Add-SPOTheme
[-Identity] <SpoThemePipeBind>
-Palette <SpoThemePalettePipeBind>
-IsInverted <Boolean>
[-Overwrite]
[<CommonParameters>]
Описание
Этот командлет создает новую тему или обновляет существующую тему. Параметры цветовых пар можно передать в виде хэш-таблицы, а параметры цветовой палитры — в виде хэш-таблицы или словаря.
Добавление темы не применяется автоматически к любому сайту. Вместо этого тема становится доступной в списке тем в разделе Изменить внешний вид для современных страниц SharePoint.
Выберите соответствующий набор параметров в зависимости от того, работаете ли вы с устаревшим или современным форматом темы. Дополнительные сведения о новом формате темы см. в разделе Тема сайта.
Примечание.
В средах с несколькими регионами темы, добавленные администратором в основном географическом регионе, автоматически распространяются и доступны по всей организации. Этот командлет не поддерживается для администраторов во вспомогательных географических регионах.
Примеры
Пример 1:
$colorPairs = @{
light = @(
@{ "accentColor" = "#03787C"; "backgroundColor" = "#FFFFFF" }
@{ "accentColor" = "#FFFFFF"; "backgroundColor" = "#03787C" }
@{ "accentColor" = "#E3FFFD"; "backgroundColor" = "#03787C" }
@{ "accentColor" = "#03787C"; "backgroundColor" = "#E3FFFD" }
@{ "accentColor" = "#FFF9E3"; "backgroundColor" = "#03787C" }
@{ "accentColor" = "#03787C"; "backgroundColor" = "#FFF9E3" }
@{ "accentColor" = "#03787C"; "backgroundColor" = "#F5F5F5" }
@{ "accentColor" = "#242424"; "backgroundColor" = "#F5F5F5" }
@{ "accentColor" = "#155473"; "backgroundColor" = "#FFFFFF" }
@{ "accentColor" = "#FFFFFF"; "backgroundColor" = "#155473" }
@{ "accentColor" = "#155473"; "backgroundColor" = "#E3FFFD" }
@{ "accentColor" = "#E3FFFD"; "backgroundColor" = "#155473" }
@{ "accentColor" = "#FFF9E3"; "backgroundColor" = "#155473" }
@{ "accentColor" = "#155473"; "backgroundColor" = "#FFF9E3" }
)
}
Add-SPOTheme -Identity "Teal Theme" -ColorPairs $colorPairs
В этом примере создается тема с параметрами "Teal Theme" цветовой пары в различных оттенках тональности.
Пример 2:
Add-SPOTheme -Identity "Teal Theme" -ColorPairs $colorPairs -Overwrite
Чтобы обновить существующую тему в новом формате, измените параметры цвета, используя тот же синтаксис, что и при создании темы.
-Overwrite Добавьте флаг в командлет Add-SPOTheme.
Пример 3.
$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
В этом примере создается тема с именем "Custom Cyan" с параметрами цветовой палитры, которые представляют собой различные оттенки голубого цвета. Обратите внимание, что параметры передаются в виде хэш-таблицы.
Примечание.
До выпуска командной консоли SPO за декабрь 2017 г. командлет Add-SPOTheme требовал, чтобы параметры цветовой палитры передавались в виде словаря. Рекомендуется использовать последнюю версию командной консоли SPO или использовать функцию HashToDictionary для преобразования хэш-таблицы в словарь при необходимости.
Пример 4. Перезапись устаревшей темы формата
Add-SPOTheme -Identity "Custom Cyan" -Palette $themepalette -IsInverted $false -Overwrite
Чтобы обновить существующую устаревшую тему формата и изменить ее параметры цвета, используйте тот же синтаксис, что и при создании темы.
-Overwrite Добавьте флаг в командлет Add-SPOTheme.
Параметры
-ColorPairs
Применимо: SharePoint Online
Задает цветовые пары темы с помощью хэш-таблицы значений слотов. Поддерживает до 16 пар цветов.
Свойства параметра
| Тип: | Microsoft.Online.SharePoint.PowerShell.SpoThemeColorPairPipeBind |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
NewThemeSet
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Identity
Применимо: SharePoint Online
Задает имя темы. Это должно однозначно идентифицировать тему.
Свойства параметра
| Тип: | Microsoft.Online.SharePoint.PowerShell.SpoThemePipeBind |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | Имя |
Наборы параметров
(All)
| Position: | 0 |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-IsInverted
Применимо: SharePoint Online
Указывает, является ли тема инвертированной с темным фоном и светлым передним планом.
Свойства параметра
| Тип: | System.Boolean |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | Нет |
Наборы параметров
LegacyThemeSet
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Overwrite
Применимо: SharePoint Online
Перезаписывает тему с тем же именем, если она существует.
Свойства параметра
| Тип: | System.Management.Automation.SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | Нет |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Palette
Применимо: SharePoint Online
Задает палитру цветов в теме в виде словаря или хэш-таблицы значений слота темы.
Свойства параметра
| Тип: | Microsoft.Online.SharePoint.PowerShell.SpoThemePalettePipeBind |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
LegacyThemeSet
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.