Add-SPOTheme
Crea un nuevo tema personalizado o sobrescribe uno existente para modificar su configuración.
Sintaxis
NewThemeSet
Add-SPOTheme
[-Identity] <SpoThemePipeBind>
-ColorPairs <SpoThemeColorPairPipeBind>
[-Overwrite]
[<CommonParameters>]
LegacyThemeSet
Add-SPOTheme
[-Identity] <SpoThemePipeBind>
-Palette <SpoThemePalettePipeBind>
-IsInverted <Boolean>
[-Overwrite]
[<CommonParameters>]
Description
Este cmdlet crea un tema nuevo o actualiza un tema existente. La configuración de pares de colores se puede pasar como una tabla hash, mientras que la configuración de la paleta de colores se puede pasar como una tabla hash o un diccionario.
Agregar un tema no se aplica automáticamente a ningún sitio. En su lugar, el tema está disponible en la lista de temas de la opción Cambiar el aspecto para las páginas modernas de SharePoint.
Elija el conjunto de parámetros adecuado en función de si está trabajando con un formato de tema heredado o moderno. Para obtener más información sobre el nuevo formato de tema, consulte Tema del sitio.
Nota:
En entornos multigeográficos, los temas agregados por un administrador en la geografía principal se propagan automáticamente y están disponibles en toda la organización. Este cmdlet no es compatible con los administradores de geografías satélite.
Ejemplos
Ejemplo 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
En este ejemplo se crea un tema con nombre "Teal Theme" y una configuración de par de colores en varios tonos de verde azulado.
Ejemplo 2:
Add-SPOTheme -Identity "Teal Theme" -ColorPairs $colorPairs -Overwrite
Para actualizar un tema existente en el nuevo formato, modifique la configuración de color con la misma sintaxis que al crear un tema. Agregue la -Overwrite marca al cmdlet de Add-SPOTheme.
Ejemplo 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
En este ejemplo, se crea un tema llamado con "Custom Cyan" una configuración de paleta de colores de varios tonos de cian. Tenga en cuenta que la configuración se pasa como una tabla hash.
Nota:
Antes de la publicació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 4: Sobrescritura de un tema de formato heredado
Add-SPOTheme -Identity "Custom Cyan" -Palette $themepalette -IsInverted $false -Overwrite
Para actualizar un tema de formato heredado existente y modificar su configuración de color, use la misma sintaxis que al crear el tema. Agregue la -Overwrite marca al cmdlet de Add-SPOTheme.
Parámetros
-ColorPairs
Aplicable: SharePoint Online
Especifica los pares de colores del tema mediante una tabla hash de valores de ranura. Admite hasta 16 pares de colores.
Propiedades de parámetro
| Tipo: | Microsoft.Online.SharePoint.PowerShell.SpoThemeColorPairPipeBind |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
NewThemeSet
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Identity
Aplicable: SharePoint Online
Especifica el nombre del tema. Esto debe identificar de forma única el tema.
Propiedades de parámetro
| Tipo: | Microsoft.Online.SharePoint.PowerShell.SpoThemePipeBind |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | Nombre |
Conjuntos de parámetros
(All)
| Posición: | 0 |
| Obligatorio: | True |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-IsInverted
Aplicable: SharePoint Online
Especifica si el tema está invertido, con un fondo oscuro y un primer plano claro.
Propiedades de parámetro
| Tipo: | System.Boolean |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | Ninguno |
Conjuntos de parámetros
LegacyThemeSet
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Overwrite
Aplicable: SharePoint Online
Sobrescribe un tema con el mismo nombre en caso de que exista.
Propiedades de parámetro
| Tipo: | System.Management.Automation.SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | Ninguno |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Palette
Aplicable: SharePoint Online
Especifica la paleta de colores en el tema, como un diccionario o una tabla hash de los valores de las ranuras temáticas.
Propiedades de parámetro
| Tipo: | Microsoft.Online.SharePoint.PowerShell.SpoThemePalettePipeBind |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
LegacyThemeSet
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.