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