Add-SPOTheme
Cria um novo tema personalizado ou substitui um tema existente para modificar suas configurações.
Sintaxe
NewThemeSet
Add-SPOTheme
[-Identity] <SpoThemePipeBind>
-ColorPairs <SpoThemeColorPairPipeBind>
[-Overwrite]
[<CommonParameters>]
LegacyThemeSet
Add-SPOTheme
[-Identity] <SpoThemePipeBind>
-Palette <SpoThemePalettePipeBind>
-IsInverted <Boolean>
[-Overwrite]
[<CommonParameters>]
Description
Este cmdlet cria um novo tema ou atualiza um tema existente. As configurações de pares de cores podem ser passadas como uma tabela de hash, enquanto as configurações de paleta de cores podem ser passadas como uma tabela de hash ou um dicionário.
Adicionar um tema não o aplica automaticamente a nenhum site. Em vez disso, o tema fica disponível na lista de temas na opção Alterar a aparência das páginas modernas do SharePoint.
Escolha o conjunto de parâmetros apropriado com base no fato de você estar trabalhando com um formato de tema herdado ou moderno. Para obter detalhes sobre o novo formato de tema, consulte Tema do site.
Observação
Em ambientes multigeográficos, os temas adicionados por um administrador na geografia principal são propagados automaticamente e disponibilizados em toda a organização. Este cmdlet não é suportado por administradores em regiões geográficas satélites.
Exemplos
Exemplo 1:
$colorPairs = @{
light = @(
@{ "accentColor" = "#03787C"; "backgroundColor" = "#FFFFFF" }
@{ "accentColor" = "#FFFFFF"; "backgroundColor" = "#03787C" }
@{ "accentColor" = "#E3FFFD"; "backgroundColor" = "#03787C" }
@{ "accentColor" = "#03787C"; "backgroundColor" = "#E3FFFD" }
@{ "accentColor" = "#FFF9E3"; "backgroundColor" = "#03787C" }
@{ "accentColor" = "#03787C"; "backgroundColor" = "#FFF9E3" }
@{ "accentColor" = "#03787C"; "backgroundColor" = "#F5F5F5" }
@{ "accentColor" = "#242424"; "backgroundColor" = "#F5F5F5" }
@{ "accentColor" = "#155473"; "backgroundColor" = "#FFFFFF" }
@{ "accentColor" = "#FFFFFF"; "backgroundColor" = "#155473" }
@{ "accentColor" = "#155473"; "backgroundColor" = "#E3FFFD" }
@{ "accentColor" = "#E3FFFD"; "backgroundColor" = "#155473" }
@{ "accentColor" = "#FFF9E3"; "backgroundColor" = "#155473" }
@{ "accentColor" = "#155473"; "backgroundColor" = "#FFF9E3" }
)
}
Add-SPOTheme -Identity "Teal Theme" -ColorPairs $colorPairs
Este exemplo cria um tema nomeado "Teal Theme" com configurações de par de cores em vários tons de azul-petróleo.
Exemplo 2:
Add-SPOTheme -Identity "Teal Theme" -ColorPairs $colorPairs -Overwrite
Para atualizar um tema existente no novo formato, modifique as configurações de cores usando a mesma sintaxe da criação de um tema. Adicione o -Overwrite sinalizador ao Add-SPOTheme cmdlet.
Exemplo 3:
$themepalette = @{
"themePrimary" = "#00ffff";
"themeLighterAlt" = "#f3fcfc";
"themeLighter" = "#daffff";
"themeLight" = "#affefe";
"themeTertiary" = "#76ffff";
"themeSecondary" = "#39ffff";
"themeDarkAlt" = "#00c4c4";
"themeDark" = "#009090";
"themeDarker" = "#005252";
"neutralLighterAlt" = "#f8f8f8";
"neutralLighter" = "#f4f4f4";
"neutralLight" = "#eaeaea";
"neutralQuaternaryAlt" = "#dadada";
"neutralQuaternary" = "#d0d0d0";
"neutralTertiaryAlt" = "#c8c8c8";
"neutralTertiary" = "#a6a6a6";
"neutralSecondaryAlt" = "#767676";
"neutralSecondary" = "#666666";
"neutralPrimary" = "#333";
"neutralPrimaryAlt" = "#3c3c3c";
"neutralDark" = "#212121";
"black" = "#000000";
"white" = "#fff";
"primaryBackground" = "#fff";
"primaryText" = "#333"
}
Add-SPOTheme -Identity "Custom Cyan" -Palette $themepalette -IsInverted $false
Neste exemplo, um tema chamado "Custom Cyan" é criado, com configurações de paleta de cores que são vários tons de ciano. Observe que as configurações são passadas como uma tabela de hash.
Observação
Antes da versão de dezembro de 2017 do Shell de Gerenciamento do SPO, o cmdlet Add-SPOTheme exigia que as configurações de paleta de cores fossem passadas como um dicionário. Recomendamos que você use a versão mais recente do Shell de Gerenciamento do SPO ou use a HashToDictionary função para converter uma tabela de hash em um dicionário, se necessário.
Exemplo 4: Substituir um tema de formato herdado
Add-SPOTheme -Identity "Custom Cyan" -Palette $themepalette -IsInverted $false -Overwrite
Para atualizar um tema de formato herdado existente e modificar suas configurações de cor, use a mesma sintaxe usada para criar o tema. Adicione o -Overwrite sinalizador ao Add-SPOTheme cmdlet.
Parâmetros
-ColorPairs
Aplicável: SharePoint Online
Especifica os pares de cores do tema usando uma tabela de hash de valores de slot. Suporta até 16 pares de cores.
Propriedades do parâmetro
| Tipo: | Microsoft.Online.SharePoint.PowerShell.SpoThemeColorPairPipeBind |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
NewThemeSet
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Identity
Aplicável: SharePoint Online
Especifica o nome do tema. Isso deve identificar exclusivamente o tema.
Propriedades do parâmetro
| Tipo: | Microsoft.Online.SharePoint.PowerShell.SpoThemePipeBind |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | Nome |
Conjuntos de parâmetros
(All)
| Cargo: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-IsInverted
Aplicável: SharePoint Online
Especifica se o tema é invertido, com um plano de fundo escuro e um primeiro plano claro.
Propriedades do parâmetro
| Tipo: | System.Boolean |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | Nenhum |
Conjuntos de parâmetros
LegacyThemeSet
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Overwrite
Aplicável: SharePoint Online
Substitui um tema com o mesmo nome caso ele exista.
Propriedades do parâmetro
| Tipo: | System.Management.Automation.SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | Nenhum |
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 |
-Palette
Aplicável: SharePoint Online
Especifica a paleta de cores no tema, como um dicionário ou tabela de hash de valores de slot de tema.
Propriedades do parâmetro
| Tipo: | Microsoft.Online.SharePoint.PowerShell.SpoThemePalettePipeBind |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
LegacyThemeSet
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| 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.