Get-SPOTheme

Description

此 Cmdlet 會傳回已命名的現有佈景主題的設定,如果未提供名稱,則會傳回所有上傳佈景主題的設定。

注意事項

為了支援一致的品牌並簡化治理,主題管理正在過渡到集中模式。

  • 主要地理位置將作為全組織主題建立和管理的中心位置。 在這裡建立的佈景主題將顯示且跨衛星地理位置適用。
  • 衛星地理系統管理員可以使用 和 Set-SPOWebTheme cmdlet,將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。

輸入

System.String

輸出

System.Object