Add-SPOTheme

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 de hash ou um dicionário.

Adicionar um tema não aplica o tema a nenhum site. Ele adiciona o tema ao repositório 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 "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.

$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 sejam passadas como um dicionário. Recomendamos que você use a versão mais recente do Shell de Gerenciamento de SPO ou use HashToDictionary a função para converter uma tabela de hash em um 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, -Overwrite mas adicione o sinalizador ao 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

-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

-Substituir

Substitui um tema com o mesmo nome caso ele exista.

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