Add-SPOTheme

Add-SPOTheme

    [-Identity] <SpoThemePipeBind>
    -ColorPairs <SpoThemeColorPairPipeBind>
    [-Overwrite]
    [<CommonParameters>]

Add-SPOTheme

    [-Identity] <SpoThemePipeBind>
    -Palette <SpoThemePalettePipeBind>
    -IsInverted <Boolean>
    [-Overwrite]
    [<CommonParameters>]

このコマンドレットは、新しいテーマを作成するか、既存のテーマを更新します。 カラー ペアの設定はハッシュ テーブルとして渡すことができます。カラー パレットの設定はハッシュ テーブルまたは辞書として渡すことができます。

テーマを追加しても、どのサイトにも自動的に適用されるわけではありません。 代わりに、モダン SharePoint ページの [ 外観の変更 ] オプションの下にあるテーマの一覧でテーマを使用できるようになります。

レガシ テーマ形式とモダン テーマ形式のどちらを使用しているかに基づいて、適切なパラメーター セットを選択します。 新しいテーマ形式の詳細については、「 サイトのテーマ」を参照してください。

$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" という名前のテーマを作成します。

Add-SPOTheme -Identity "Teal Theme" -ColorPairs $colorPairs -Overwrite

既存のテーマを新しい形式で更新するには、テーマ作成時と同じ構文を使用して色設定を変更します。 Add-SPOTheme コマンドレットに -Overwrite フラグを追加します。

$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" という名前のテーマが作成され、カラー パレットはさまざまな濃淡のシアンに設定されます。 設定はハッシュ テーブルとして渡されることに注意してください。

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

既存の従来の形式のテーマを更新して色設定を変更するには、テーマの作成時と同じ構文を使用します。 Add-SPOTheme コマンドレットに -Overwrite フラグを追加します。

このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、「about_CommonParameters」を参照してください。