Add-SPOTheme

Módulo:

Microsoft.Online.SharePoint.PowerShell

Se aplica a:

SharePoint Online

Crea un nuevo tema personalizado o sobrescribe un tema existente para modificar su configuración.

Syntax

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

Description

El cmdlet Add-SPOTheme crea un nuevo tema o actualiza un tema existente. La configuración de la paleta de colores se puede pasar como una tabla hash o un diccionario.

Agregar un tema no aplica el tema a ningún sitio. Agrega el tema al almacén de inquilinos y, a continuación, el tema está disponible en la lista de temas en la opción Cambiar la apariencia de las páginas modernas.

Ejemplos

Ejemplo 1

En este ejemplo, se crea un nuevo tema denominado "Custom Cyan" , con la configuración de la paleta de colores que son varios tonos de cian. Tenga en cuenta que la configuración se pasa como una tabla 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

Nota:

Antes de la versión de diciembre de 2017 del Shell de administración de SPO, el cmdlet Add-SPOTheme requería que la configuración de la paleta de colores se pasara como diccionario. Se recomienda usar la versión más reciente del Shell de administración de SPO o usar la HashToDictionary función para convertir una tabla hash en un diccionario si es necesario.

Ejemplo 2

Si desea actualizar un tema existente (por ejemplo, para modificar algunos de sus valores de color), use la misma sintaxis que se mostró anteriormente, pero agregue la -Overwrite marca al cmdlet Add-SPOTheme .

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

Parámetros

-Identity

Especifica el nombre del tema. Esto debe identificar de forma única el 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 si el tema está invertido, con un fondo oscuro y un primer 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

Sobrescribe un tema con el mismo nombre en caso de que 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 la paleta de colores del tema, como un diccionario de valores de ranura 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