Add-SPOTheme
Erstellt ein neues benutzerdefiniertes Design oder überschreibt ein vorhandenes Design, um die 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
Mit diesem Cmdlet wird ein neues Design erstellt oder ein vorhandenes Design aktualisiert. 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 eine 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 geeigneten Parametersatz aus, je nachdem, ob Sie mit einem Legacy- oder Modern-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 Geographie hinzugefügt wurden, automatisch verteilt und sind in der gesamten 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 einem benannten "Teal Theme" Design mit Farbpaareinstellungen in verschiedenen Blaugrüntönen 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 derselben Syntax wie beim Erstellen eines Designs. Fügen Sie das -Overwrite Flag dem Add-SPOTheme Cmdlet 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 Cyan-Schattierungen aufweisen. Beachten Sie, dass die Einstellungen als Hashtabelle übergeben werden.
Hinweis
Vor der Veröffentlichung der SPO-Verwaltungsshell vom Dezember 2017 erforderte das Add-SPOTheme-Cmdlet , dass Farbpaletteneinstellungen als Wörterbuch übergeben werden. Es wird empfohlen, die neueste Version der SPO Management Shell zu verwenden oder die HashToDictionary Funktion zu nutzen, um bei Bedarf 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 Legacy-Formatdesign zu aktualisieren und seine Farbeinstellungen zu ändern, verwenden Sie dieselbe Syntax wie beim Erstellen des Designs. Fügen Sie das -Overwrite Flag dem Add-SPOTheme Cmdlet hinzu.
Parameter
-ColorPairs
Anwendbar: SharePoint Online
Gibt die Farbpaare des Designs mithilfe einer Hashtabelle mit 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 gleichnamiges Design, 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 mit Design-Slotwerten 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.