Get-SPOTheme
Beschreibung
Dieses Cmdlet gibt die Einstellungen für ein benanntes vorhandenes Design oder für alle hochgeladenen Designs zurück, wenn kein Name angegeben wird.
Hinweis
Um ein konsistentes Branding zu unterstützen und die Governance zu vereinfachen, wird die Designverwaltung auf ein zentralisiertes Modell umgestellt.
- Der primäre geografische Raum dient als zentraler Ort für die organizationweite Designerstellung und -verwaltung. Hier erstellte Designs sind in allen Satellitenregionen sichtbar und anwendbar.
- Die Satelliten-Geo-Administratoren können Designs aus dem primären Geo anzeigen und mit einem Cmdlet auf ihre eigenen Websites
Get-SPOThemeSet-SPOWebThemeanwenden. Designs, die zuvor in Satelliten-Geos erstellt wurden, stehen weiterhin zur Verwendung zur Verfügung. Das Erstellen neuer Designs in Satellitenregionen wird jedoch in Zukunft nicht mehr unterstützt .
Beispiele
Beispiel 1
In diesem Beispiel wird gezeigt, wie Sie mit dem Cmdlet Get-SPOTheme die Einstellungen für das Design zurückgeben, das "Custom Cyan" im Beispiel für das Cmdlet Add-SPOTheme erstellt wurde. Beachten Sie, dass in diesem Beispiel der PowerShell-Filter ConvertTo-Json verwendet wird, um das Design im JSON-Format anzuzeigen.
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
}
Wenn das Design im Legacy-Format vorliegt, lautet die Ausgabe:
{
"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
}
Beispiel 2
Um alle hochgeladenen Designs zurückzugeben, verwenden Sie den Befehl Get-SPOTheme ohne Argumente.
Get-SPOTheme -IncludeGlobalTheme
Parameter
-IncludeGlobalTheme
Anwendbar: SharePoint Online
Bei Angabe dieses Cmdlets werden alle globalen Designs zurückgegeben, die für den Mandanten verfügbar sind. Dazu gehören sowohl Designs, die mit PowerShell erstellt wurden, als auch Designs, die im Brand Center erstellt wurden.
Für Satelliten-Geos werden auch die globalen Designs zurückgegeben, IncludeGlobalTheme die im primären Geo definiert sind.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Name
Anwendbar: SharePoint Online
Der Name des Designs.
Parametereigenschaften
| Typ: | System.String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 0 |
| Obligatorisch: | False |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter about_CommonParameters.