Compartilhar via


Get-SPOTheme

Description

Este cmdlet devolve as definições de um tema existente com nome ou para todos os temas carregados se não for fornecido nenhum nome.

Observação

Para suportar uma imagem corporativa consistente e simplificar a governação, a gestão de temas está em transição para um modelo centralizado.

  • A área geográfica primária funcionará como a localização central para a criação e gestão de temas em toda a organização. Os temas criados aqui serão visíveis e aplicáveis em áreas geográficas de satélite.
  • Os Administradores Geográficos de satélite poderão ver e aplicar temas da área geográfica primária aos seus próprios sites através da utilização Get-SPOTheme e Set-SPOWebTheme do cmdlet. Os temas criados anteriormente na área geográfica de satélite permanecerão disponíveis para utilização. No entanto, a criação de novos temas em áreas geográficas por satélite deixará de ser suportada no futuro.

Exemplos

Exemplo 1

Este exemplo mostra como utilizar o cmdlet Get-SPOTheme para devolver as definições do "Custom Cyan" tema criado no exemplo para o cmdlet Add-SPOTheme . Tenha em atenção que este exemplo utiliza o filtro do PowerShell ConvertTo-Json para apresentar o tema no formato 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
}

Se o tema estiver no formato legado, a saída será:

{
    "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
}

Exemplo 2

Para devolver todos os temas carregados, utilize o comando Get-SPOTheme sem argumentos.

Get-SPOTheme

Parâmetros

-Name

Aplicável: SharePoint Online

O nome do tema.

Propriedades do parâmetro

Tipo:System.String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:0
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.

Entradas

System.String

Saídas

System.Object