Add-SPOTheme
Crea un nuevo tema personalizado o sobrescribe un tema 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 nuevo tema 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 en la opción Cambiar la apariencia de 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, vea 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 zonas geográficas 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 denominado "Teal Theme" con la configuración de par de colores en varios tonos de teal.
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 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 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.
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 4: Sobrescribir 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 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 del 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 |
| Mandatory: | 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 del 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 |
| Mandatory: | 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 del 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 |
| Mandatory: | 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 del 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 |
| Mandatory: | 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 del tema, como un diccionario o tabla hash de valores de ranura de tema.
Propiedades del 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 |
| Mandatory: | 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.