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

Adicionar um tema não aplica o tema a nenhum site. Ele adiciona o tema ao seu repositório de locatários e, em seguida, o tema está disponível na lista de temas sob a opção Alterar a opção de 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 de 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 de SPO ou use a HashToDictionary 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, mas adicione o -Overwrite sinalizador ao cmdlet Add-SPOTheme .

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

Parâmetros

-Identity

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

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

-IsInverted

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

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

-Overwrite

Substitui um tema do mesmo nome caso ele exista.

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

-Palette

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
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Online

Partilhar via