Get-SPOTheme

模块:: Microsoft.Online.SharePoint.PowerShell Module

说明

此 cmdlet 返回命名现有主题的设置，如果未提供名称，则返回所有上传的主题的设置。

注意

为了支持一致的品牌打造并简化治理，主题管理正在过渡到集中式模型。

主地理位置将充当组织范围主题创建和管理的中心位置。此处创建的主题将跨卫星地理区域可见且适用。
附属 地理管理员 将能够使用 Get-SPOTheme 和 Set-SPOWebTheme cmdlet 查看主要地理位置中的主题并将其应用于其自己的站点。以前在附属地理位置中创建的主题仍可供使用。但是，今后 将不再支持在卫星地理区域中创建新主题 。

示例

示例 1

此示例演示如何使用 Get-SPOTheme cmdlet 返回在 Add-SPOTheme cmdlet 示例中创建的主题设置"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

参数

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