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 年 12 月のリリースより前に、 Add-SPOTheme コマンドレットでは、カラーパレットの設定を辞書として渡す必要がありました。 SPO 管理シェルの最新バージョンを使用するか、関数を HashToDictionary 使用して、必要に応じてハッシュテーブルをディクショナリに変換することをお勧めします。

例 2

既存のテーマを更新する場合 (たとえば、色の設定の一部を変更する場合)、前に示したのと同じ構文を使用しますが、フラグを Add-SPOTheme コマンドレットに追加-Overwriteします。

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