Get-SPOTheme
Description
此 Cmdlet 會傳回已命名的現有佈景主題的設定,如果未提供名稱,則會傳回所有上傳佈景主題的設定。
注意事項
為了支援一致的品牌並簡化治理,主題管理正在過渡到集中模式。
- 主要地理位置將作為全組織主題建立和管理的中心位置。 在這裡建立的佈景主題將顯示且跨衛星地理位置適用。
- 衛星地理系統管理員可以使用 和
Set-SPOWebThemecmdlet,將Get-SPOTheme主題從主要地理位置套用至自己的網站。 先前在衛星地理位置內建立的佈景主題仍然可供使用。 不過,往後 將不再支援在衛星地理位置中建立新佈景主題 。
範例
範例 1
此範例示範如何使用 Get-SPOTheme Cmdlet 傳回在 Add-SPOTheme Cmdlet 範例中建立的佈景主題設定"Custom Cyan"。 請注意,此範例使用 PowerShell 篩選以 JSON ConvertTo-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
指定時,此 Cmdlet 會傳回租用戶可用的所有全域主題。 這包括使用 PowerShell 建立的佈景主題,以及在品牌中心中建立的佈景主題。
針對衛星地理位置, IncludeGlobalTheme 也會傳回主要地理位置中定義的全域主題。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Name
適用對象:SharePoint Online
佈景主題的名稱。
參數屬性
| 類型: | System.String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 0 |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援常見參數: -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters。