Add-SPOTheme

Référence

Module:: Microsoft.Online.SharePoint.PowerShell

S’applique à:: SharePoint Online

Crée un thème personnalisé ou remplace un thème existant pour modifier ses paramètres.

Syntax

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

Description

L’applet de commande Add-SPOTheme crée un thème ou met à jour un thème existant. Les paramètres de palette de couleurs peuvent être passés sous la forme d’une table de hachage ou d’un dictionnaire.

L’ajout d’un thème n’applique le thème à aucun site. Il ajoute le thème à votre magasin de locataires, puis le thème est disponible dans la liste des thèmes sous l’option Modifier l’apparence pour les pages modernes.

Exemples

Exemple 1

Dans cet exemple, un nouveau thème nommé "Custom Cyan" est créé, avec des paramètres de palette de couleurs qui sont différentes nuances de cyan. Notez que les paramètres sont passés sous forme de table de hachage.

$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

Remarque

Avant la version de décembre 2017 de SPO Management Shell, l’applet de commande Add-SPOTheme nécessitait que les paramètres de palette de couleurs soient passés en tant que dictionnaire. Nous vous recommandons d’utiliser la dernière version de SPO Management Shell ou d’utiliser la HashToDictionary fonction pour convertir une table de hachage en dictionnaire si nécessaire.

Exemple 2

Si vous souhaitez mettre à jour un thème existant (par exemple, pour modifier certains de ses paramètres de couleur), utilisez la même syntaxe que celle indiquée précédemment, mais ajoutez l’indicateur -Overwrite à l’applet de commande Add-SPOTheme .

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

Paramètres

-Identity

Spécifie le nom du thème. Cela doit identifier le thème de manière unique.

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

-IsInverted

Spécifie si le thème est inversé, avec un arrière-plan sombre et un premier plan clair.

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

-Overwrite

Remplace un thème du même nom s’il existe.

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

-Palette

Spécifie la palette de couleurs dans le thème, sous la forme d’un dictionnaire de valeurs d’emplacement de thème.

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