Get-SPOTheme
Description
Cette applet de commande renvoie les paramètres d’un thème existant nommé, ou de tous les thèmes chargés si aucun nom n’est fourni.
Remarque
Pour soutenir une image de marque cohérente et simplifier la gouvernance, la gestion des thèmes passe à un modèle centralisé.
- La zone géographique principale sert d’emplacement central pour la création et la gestion de thèmes à l’échelle de l’organisation. Les thèmes créés ici seront visibles et applicables dans toutes les zones géographiques satellites.
- Les administrateurs géographiques satellites pourront afficher et appliquer des thèmes de la zone géographique principale à leurs propres sites à l’aide d’un
Get-SPOThemeSet-SPOWebThemecmdlet. Les thèmes précédemment créés dans les régions satellites resteront disponibles. Toutefois, la création de nouveaux thèmes dans les géos satellites ne sera plus prise en charge à l’avenir.
Exemples
Exemple 1
Cet exemple montre comment utiliser l’applet de commande Get-SPOTheme pour retourner les paramètres du "Custom Cyan" thème créé dans l’exemple de l’applet de commande Add-SPOTheme . Notez que cet exemple utilise le filtre PowerShell ConvertTo-Json pour afficher le thème au format JSON.
Get-SPOTheme -Name "Custom Cyan" | ConvertTo-Json -Depth 4
{
"Name": "Custom Cyan",
"Palette": null,
"ColorPairs": {
"light": [
{"accentColor": "#0078D4", "backgroundColor": "#FFFFFF"},
{"accentColor": "#FFFFFF", "backgroundColor": "#0078D4"}
]
},
"IsInverted": false,
"Editable": true
}
Si le thème est au format hérité, la sortie sera :
{
"Name": "Custom Cyan",
"Palette": {
"themeLight": "#affefe",
"themeTertiary": "#76ffff",
"black": "#000000",
"neutralSecondary": "#666666",
"neutralTertiaryAlt": "#c8c8c8",
"themeSecondary": "#39ffff",
"themeDarker": "#005252",
"primaryBackground": "#fff",
"neutralQuaternary": "#d0d0d0",
"neutralPrimaryAlt": "#3c3c3c",
"neutralPrimary": "#333",
"themeDark": "#009090",
"themeLighter": "#daffff",
"neutralTertiary": "#a6a6a6",
"neutralQuaternaryAlt": "#dadada",
"themeLighterAlt": "#f3fcfc",
"white": "#fff",
"neutralSecondaryAlt": "#767676",
"neutralLighter": "#f4f4f4",
"neutralLight": "#eaeaea",
"neutralDark": "#212121",
"themeDarkAlt": "#00c4c4",
"neutralLighterAlt": "#f8f8f8",
"primaryText": "#333",
"themePrimary": "#00ffff"
},
"IsInverted": false,
"Editable": true
}
Exemple 2
Pour renvoyer tous les thèmes téléchargés, utilisez la commande Get-SPOTheme sans arguments.
Get-SPOTheme -IncludeGlobalTheme
Paramètres
-IncludeGlobalTheme
Applicable : SharePoint Online
Lorsqu’elle est spécifiée, cette applet de commande renvoie tous les thèmes globaux disponibles pour le client. Cela inclut les thèmes créés à l’aide de PowerShell ainsi que les thèmes créés dans le Centre de marque.
Pour les géos satellites, IncludeGlobalTheme retourne également les thèmes globaux définis dans la zone géographique principale.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
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 |
-Name
Applicable : SharePoint Online
Nom du thème.
Propriétés du paramètre
| Type: | System.String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 0 |
| Obligatoire: | False |
| Valeur du pipeline: | True |
| 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.