Get-SPOTheme
説明
このコマンドレットは、名前付きの既存のテーマ、または名前が指定されていない場合はアップロードされたすべてのテーマの設定を返します。
注:
一貫したブランディングをサポートし、ガバナンスを簡素化するために、テーマ管理は一元化されたモデルに移行しています。
- プライマリ geo は、organization全体のテーマの作成と管理の中心的な場所として機能します。 ここで作成されたテーマは表示され、サテライト地域全体に適用できます。
- サテライト Geo 管理者 は、
Get-SPOThemeとSet-SPOWebThemeコマンドレットを使用して、プライマリ ジオからのテーマを表示し、自分のサイトに適用できます。 サテライト ジオ内で以前に作成されたテーマは引き続き使用できます。 ただし、 衛星地域での新しいテーマの作成は今後サポートされなくなります 。
例
例 1
この例では、Get-SPOTheme コマンドレットを使用して、Add-SPOTheme コマンドレットの例で作成した"Custom Cyan"テーマの設定を返す方法を示します。 この例では、PowerShell ConvertTo-Json フィルターを使用してテーマを JSON 形式で表示することに注意してください。
Get-SPOTheme -Name "Custom Cyan" | ConvertTo-Json -Depth 4
{
"Name": "Custom Cyan",
"Palette": null,
"ColorPairs": {
"light": [
{"accentColor": "#0078D4", "backgroundColor": "#FFFFFF"},
{"accentColor": "#FFFFFF", "backgroundColor": "#0078D4"}
]
},
"IsInverted": false,
"Editable": true
}
テーマが従来の形式の場合、出力は次のようになります。
{
"Name": "Custom Cyan",
"Palette": {
"themeLight": "#affefe",
"themeTertiary": "#76ffff",
"black": "#000000",
"neutralSecondary": "#666666",
"neutralTertiaryAlt": "#c8c8c8",
"themeSecondary": "#39ffff",
"themeDarker": "#005252",
"primaryBackground": "#fff",
"neutralQuaternary": "#d0d0d0",
"neutralPrimaryAlt": "#3c3c3c",
"neutralPrimary": "#333",
"themeDark": "#009090",
"themeLighter": "#daffff",
"neutralTertiary": "#a6a6a6",
"neutralQuaternaryAlt": "#dadada",
"themeLighterAlt": "#f3fcfc",
"white": "#fff",
"neutralSecondaryAlt": "#767676",
"neutralLighter": "#f4f4f4",
"neutralLight": "#eaeaea",
"neutralDark": "#212121",
"themeDarkAlt": "#00c4c4",
"neutralLighterAlt": "#f8f8f8",
"primaryText": "#333",
"themePrimary": "#00ffff"
},
"IsInverted": false,
"Editable": true
}
例 2
アップロードされたすべてのテーマを返すには、 Get-SPOTheme コマンドを引数を指定せずに使用します。
Get-SPOTheme -IncludeGlobalTheme
パラメーター
-IncludeGlobalTheme
適用対象: SharePoint Online
指定した場合、このコマンドレットはテナントで使用できるすべてのグローバル テーマを返します。 これには、PowerShell を使用して作成されたテーマと、ブランド センターで作成されたテーマが含まれます。
衛星地域の場合、 IncludeGlobalTheme はプライマリ地域で定義されたグローバル テーマも返します。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Name
適用対象: SharePoint Online
テーマの名前。
パラメーターのプロパティ
| 型: | System.String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 0 |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、「about_CommonParameters」を参照してください。