Add-SPOTheme
Crée un thème personnalisé ou remplace un thème existant pour modifier ses paramètres.
Syntaxe
NewThemeSet
Add-SPOTheme
[-Identity] <SpoThemePipeBind>
-ColorPairs <SpoThemeColorPairPipeBind>
[-Overwrite]
[<CommonParameters>]
LegacyThemeSet
Add-SPOTheme
[-Identity] <SpoThemePipeBind>
-Palette <SpoThemePalettePipeBind>
-IsInverted <Boolean>
[-Overwrite]
[<CommonParameters>]
Description
Cette applet de commande crée un thème ou met à jour un thème existant. Les paramètres des paires de couleurs peuvent être transmis sous forme de table de hachage, tandis que les paramètres de palette de couleurs peuvent être transmis sous forme de table de hachage ou de dictionnaire.
L’ajout d’un thème ne l’applique pas automatiquement à n’importe quel site. À la place, le thème devient disponible dans la liste des thèmes sous l’option Modifier l’apparence des pages SharePoint modernes.
Choisissez le jeu de paramètres approprié selon que vous utilisez un format de thème hérité ou moderne. Pour plus d’informations sur le nouveau format de thème, voir Thème du site.
Remarque
Dans les environnements multigéographiques, les thèmes ajoutés par un administrateur dans la zone géographique principale sont automatiquement propagés et disponibles dans toute l’organisation. Cette applet de commande n’est pas prise en charge par les administrateurs dans les zones géographiques satellites.
Exemples
Exemple 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
Cet exemple crée un thème nommé "Teal Theme" avec des paramètres de paire de couleurs dans différentes nuances de sarcelle.
Exemple 2 :
Add-SPOTheme -Identity "Teal Theme" -ColorPairs $colorPairs -Overwrite
Pour mettre à jour un thème existant dans le nouveau format, modifiez les paramètres de couleur à l’aide de la même syntaxe que lors de la création d’un thème. Ajoutez l’indicateur -Overwrite à l’applet de commande Add-SPOTheme.
Exemple 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
Dans cet exemple, un 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 transmis sous forme de table de hachage.
Remarque
Avant la publication 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 transmis sous forme de dictionnaire. Il est recommandé 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 4 : Remplacer un thème de mise en forme hérité
Add-SPOTheme -Identity "Custom Cyan" -Palette $themepalette -IsInverted $false -Overwrite
Pour mettre à jour un thème de format hérité existant et modifier ses paramètres de couleur, utilisez la même syntaxe que lors de la création du thème. Ajoutez l’indicateur -Overwrite à l’applet de commande Add-SPOTheme.
Paramètres
-ColorPairs
Applicable : SharePoint Online
Spécifie les paires de couleurs du thème à l’aide d’une table de hachage des valeurs d’emplacements. Prend en charge jusqu’à 16 paires de couleurs.
Propriétés du paramètre
| Type: | Microsoft.Online.SharePoint.PowerShell.SpoThemeColorPairPipeBind |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
NewThemeSet
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Identity
Applicable : SharePoint Online
Spécifie le nom du thème. Cela doit identifier de manière unique le thème.
Propriétés du paramètre
| Type: | Microsoft.Online.SharePoint.PowerShell.SpoThemePipeBind |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Nom |
Jeux de paramètres
(All)
| Position: | 0 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-IsInverted
Applicable : SharePoint Online
Indique si le thème est inversé, avec un arrière-plan sombre et un premier plan clair.
Propriétés du paramètre
| Type: | System.Boolean |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Aucun |
Jeux de paramètres
LegacyThemeSet
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Overwrite
Applicable : SharePoint Online
Remplace un thème du même nom s’il existe.
Propriétés du paramètre
| Type: | System.Management.Automation.SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Aucun |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Palette
Applicable : SharePoint Online
Spécifie la palette de couleurs du thème, sous la forme d’un dictionnaire ou d’une table de hachage des valeurs d’emplacement de thème.
Propriétés du paramètre
| Type: | Microsoft.Online.SharePoint.PowerShell.SpoThemePalettePipeBind |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
LegacyThemeSet
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres communs : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.