Add-SPOTheme
Cria um novo tema personalizado ou substitui um tema existente para modificar as respetivas definiçõ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 definições de pares de cores podem ser transmitidas como uma tabela hash, enquanto as definições da paleta de cores podem ser transmitidas como uma tabela 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 o aspeto das páginas modernas do SharePoint.
Escolha o conjunto de parâmetros adequado com base no facto de estar a trabalhar com um formato de tema legado 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 primária são automaticamente propagados e disponíveis em toda a organização. Este cmdlet não é suportado para administradores em geografias de satélite.
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 com o nome "Teal Theme" com definições de par de cores em vários tons de teal.
Exemplo 2:
Add-SPOTheme -Identity "Teal Theme" -ColorPairs $colorPairs -Overwrite
Para atualizar um tema existente no novo formato, modifique as definições de cor com a mesma sintaxe que ao criar um tema. Adicione o -Overwrite sinalizador ao cmdlet Add-SPOTheme.
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, é criado um tema com o nome "Custom Cyan" , com definições de paleta de cores que são vários tons de yan. Tenha em atenção que as definições são transmitidas como uma tabela hash.
Observação
Antes da versão de dezembro de 2017 da Shell de Gestão do SPO, o cmdlet Add-SPOTheme exigia que as definições da paleta de cores fossem transmitidas como um dicionário. Recomendamos que utilize a versão mais recente da Shell de Gestão do SPO ou utilize a HashToDictionary função para converter uma tabela hash num dicionário, se necessário.
Exemplo 4: substituir um tema de formato legado
Add-SPOTheme -Identity "Custom Cyan" -Palette $themepalette -IsInverted $false -Overwrite
Para atualizar um tema de formato legado existente e modificar as respetivas definições de cor, utilize a mesma sintaxe que ao criar o tema. Adicione o -Overwrite sinalizador ao cmdlet Add-SPOTheme.
Parâmetros
-ColorPairs
Aplicável: SharePoint Online
Especifica os pares de cores do tema com uma tabela hash de valores de bloco. 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. Esta ação tem de 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 está invertido, com um 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 no caso de existir.
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 hash de valores de blocos 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 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.