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 passés en tant que table de hachage, tandis que les paramètres de palette de couleurs peuvent être passés en tant que table de hachage ou dictionnaire.
L’ajout d’un thème ne l’applique automatiquement à aucun site. Au lieu de cela, le thème devient disponible dans la liste des thèmes sous l’option Modifier l’apparence pour les pages SharePoint modernes.
Choisissez l’ensemble de paramètres approprié selon que vous travaillez avec un format de thème hérité ou moderne. Pour plus d’informations sur le nouveau format de thème, consultez 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 l’ensemble des organization. Cette applet de commande n’est pas prise en charge pour 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 passés sous forme de table de hachage.
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 4 : Remplacer un thème de format 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 de valeurs d’emplacement. 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 le thème de manière unique.
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
Spécifie 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 dans le 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 courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.