Add-SPOTheme

新しいカスタム テーマを作成するか、既存のテーマを上書きしてその設定を変更します。

構文

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
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