Get-SPOTheme

Description

Este cmdlet retorna as configurações para um tema existente nomeado ou para todos os temas carregados se nenhum nome for fornecido.

Observação

Para dar suporte a uma identidade visual consistente e simplificar a governança, o gerenciamento de temas está em transição para um modelo centralizado.

  • A área geográfica principal atuará como o local central para a criação e o gerenciamento de temas em toda a organização. Os temas criados aqui serão visíveis e aplicáveis em todas as áreas geográficas de satélite.
  • Os Administradores Geográficos satélites poderão exibir e aplicar temas da área geográfica primária aos seus próprios sites usando Get-SPOTheme um Set-SPOWebTheme cmdlet. Os temas criados anteriormente nas áreas geográficas satélites permanecerão disponíveis para uso. No entanto, a criação de novos temas em áreas geográficas satélites não terá mais suporte no futuro.

Exemplos

Exemplo 1

Este exemplo mostra como usar o cmdlet Get-SPOTheme para retornar as configurações do "Custom Cyan" tema criado no exemplo do cmdlet Add-SPOTheme . Observe que este exemplo usa o filtro do PowerShell ConvertTo-Json para exibir 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 herdado, 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 retornar todos os temas carregados, use o comando Get-SPOTheme sem argumentos.

Get-SPOTheme -IncludeGlobalTheme

Parâmetros

-IncludeGlobalTheme

Aplicável: SharePoint Online

Quando especificado, esse cmdlet retorna todos os temas globais disponíveis para o locatário. Isso inclui temas criados usando o PowerShell, bem como temas criados no Centro de Marcas.

Para áreas geográficas de satélite, IncludeGlobalTheme também retorna os temas globais definidos na área geográfica principal.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

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

-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 dá suporte aos 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