Add-SPOTheme

Referência

Módulo:: Microsoft.Online.SharePoint.PowerShell

Aplica-se a:: SharePoint Online

Cria um novo tema personalizado ou substitui um tema existente para modificar suas configurações.

Syntax

Add-SPOTheme
   -Identity <SpoThemePipeBind>
   -IsInverted <bool>
   -Overwrite
   -Palette <SpoThemePalettePipeBind> 
   [<CommonParameters>]

Description

O cmdlet Add-SPOTheme cria um novo tema ou atualiza um tema existente. As configurações da paleta de cores podem ser passadas como uma tabela hash ou um dicionário.

Adicionar um tema não aplica o tema a nenhum site. Ele adiciona o tema ao seu armazenamento de locatários e, em seguida, o tema está disponível na lista de temas sob a opção Alterar a aparência para páginas modernas.

Exemplos

Exemplo 1

Neste exemplo, um novo tema chamado é criado, com configurações de paleta de cores que "Custom Cyan" são vários tons de ciano. Observe que as configurações são passadas como uma tabela de hash.

$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

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 da paleta de cores fosse passadas como dicionário. Recomendamos que você use a versão mais recente do Shell de Gerenciamento de SPO ou use a função para converter uma tabela de hash em um HashToDictionary dicionário, se necessário.

Exemplo 2

Se você quiser atualizar um tema existente (para modificar algumas de suas configurações de cor, por exemplo), use a mesma sintaxe mostrada anteriormente, mas adicione o sinalizador ao -Overwrite cmdlet Add-SPOTheme.

Add-SPOTheme -Identity "Custom Cyan" -Palette $themepalette -IsInverted $false -Overwrite

Parâmetros

-Identidade

Especifica o nome do tema. Isso deve identificar exclusivamente o tema.

Type:	SpoThemePalettePipeBind
Aliases:	Name
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Online

-IsInverted

Especifica se o tema é invertido, com um plano de fundo escuro e um primeiro plano claro.

Type:	Boolean
Aliases:	None
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Online

-Overwrite

Substitui um tema com o mesmo nome caso exista.

Type:	SwitchParameter
Aliases:	None
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Online

-Paleta

Especifica a paleta de cores no tema, como um dicionário de valores de slot de tema.

Type:	SpoThemePalettePipeBind
Aliases:	None
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Online