Add-SPOTheme
Erstellt ein neues benutzerdefiniertes Design oder überschreibt ein vorhandenes Design, um seine Einstellungen zu ändern.
Syntax
NewThemeSet
Add-SPOTheme
[-Identity] <SpoThemePipeBind>
-ColorPairs <SpoThemeColorPairPipeBind>
[-Overwrite]
[<CommonParameters>]
LegacyThemeSet
Add-SPOTheme
[-Identity] <SpoThemePipeBind>
-Palette <SpoThemePalettePipeBind>
-IsInverted <Boolean>
[-Overwrite]
[<CommonParameters>]
Beschreibung
Dieses Cmdlet erstellt ein neues Design oder aktualisiert ein vorhandenes Design. Die Farbpaareinstellungen können als Hashtabelle übergeben werden, während die Farbpaletteneinstellungen entweder als Hashtabelle oder als Wörterbuch übergeben werden können.
Durch das Hinzufügen eines Designs wird es nicht automatisch auf jede Website angewendet. Stattdessen wird das Design in der Liste der Designs unter der Option Aussehen ändern für moderne SharePoint-Seiten verfügbar.
Wählen Sie den entsprechenden Parametersatz aus, je nachdem, ob Sie mit einem Legacy- oder einem modernen Designformat arbeiten. Ausführliche Informationen zum neuen Designformat finden Sie unter Websitedesign.
Hinweis
In Multi-Geo-Umgebungen werden Designs, die von einem Administrator in der primären Geografie hinzugefügt wurden, automatisch verteilt und über die organization verfügbar. Dieses Cmdlet wird für Administratoren in Satellitenregionen nicht unterstützt.
Beispiele
Beispiel 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
In diesem Beispiel wird ein Design mit dem Namen "Teal Theme" mit Farbpaareinstellungen in verschiedenen Tealschattierungen erstellt.
Beispiel 2:
Add-SPOTheme -Identity "Teal Theme" -ColorPairs $colorPairs -Overwrite
Um ein vorhandenes Design im neuen Format zu aktualisieren, ändern Sie die Farbeinstellungen mit der gleichen Syntax wie beim Erstellen eines Designs. Fügen Sie das -Overwrite Flag dem Cmdlet Add-SPOTheme hinzu.
Beispiel 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
In diesem Beispiel wird ein Design mit dem Namen "Custom Cyan" erstellt, mit Farbpaletteneinstellungen, die verschiedene Zyan-Schattierungen sind. Beachten Sie, dass die Einstellungen als Hashtabelle übergeben werden.
Hinweis
Vor dem Release der SPO-Verwaltungsshell vom Dezember 2017 erforderte das Cmdlet Add-SPOTheme , dass Farbpaletteneinstellungen als Wörterbuch übergeben werden. Es wird empfohlen, bei Bedarf die neueste Version der SPO-Verwaltungsshell oder die HashToDictionary -Funktion zu verwenden, um eine Hashtabelle in ein Wörterbuch zu konvertieren.
Beispiel 4: Überschreiben eines Legacyformatdesigns
Add-SPOTheme -Identity "Custom Cyan" -Palette $themepalette -IsInverted $false -Overwrite
Um ein vorhandenes Legacyformatdesign zu aktualisieren und dessen Farbeinstellungen zu ändern, verwenden Sie die gleiche Syntax wie beim Erstellen des Designs. Fügen Sie das -Overwrite Flag dem Cmdlet Add-SPOTheme hinzu.
Parameter
-ColorPairs
Anwendbar: SharePoint Online
Gibt die Farbpaare des Designs mithilfe einer Hashtabelle von Slotwerten an. Unterstützt bis zu 16 Farbpaare.
Parametereigenschaften
| Typ: | Microsoft.Online.SharePoint.PowerShell.SpoThemeColorPairPipeBind |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
NewThemeSet
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Identity
Anwendbar: SharePoint Online
Gibt den Namen des Designs an. Dadurch muss das Design eindeutig identifiziert werden.
Parametereigenschaften
| Typ: | Microsoft.Online.SharePoint.PowerShell.SpoThemePipeBind |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Name |
Parametersätze
(All)
| Position: | 0 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-IsInverted
Anwendbar: SharePoint Online
Gibt an, ob das Design invertiert ist, mit einem dunklen Hintergrund und einem hellen Vordergrund.
Parametereigenschaften
| Typ: | System.Boolean |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Keine |
Parametersätze
LegacyThemeSet
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Overwrite
Anwendbar: SharePoint Online
Überschreibt ein Design mit demselben Namen, falls es vorhanden ist.
Parametereigenschaften
| Typ: | System.Management.Automation.SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Keine |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Palette
Anwendbar: SharePoint Online
Gibt die Farbpalette im Design als Wörterbuch oder Hashtabelle von Designslotwerten an.
Parametereigenschaften
| Typ: | Microsoft.Online.SharePoint.PowerShell.SpoThemePalettePipeBind |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
LegacyThemeSet
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| 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.