Add-SPOTheme

Erstellt ein neues benutzerdefiniertes Design oder überschreibt ein vorhandenes Design, um seine Einstellungen zu ändern.

Syntax

Add-SPOTheme
   -Identity <SpoThemePipeBind>
   -IsInverted <bool>
   -Overwrite
   -Palette <SpoThemePalettePipeBind> 
   [<CommonParameters>]

Beschreibung

Das Cmdlet "Add-SPOTheme " erstellt ein neues Design oder aktualisiert ein vorhandenes Design. Die Farbpaletteneinstellungen können als Hashtabelle oder Wörterbuch übergeben werden.

Durch das Hinzufügen eines Designs wird das Design nicht auf Websites angewendet. Es fügt das Design ihrem Mandantenspeicher hinzu, und dann ist das Design in der Liste der Designs unter der Option " Aussehen ändern " für moderne Seiten verfügbar.

Beispiele

Beispiel 1

In diesem Beispiel wird ein neues Design mit dem Namen "Custom Cyan" "Farbpaletteneinstellungen" erstellt, bei denen es sich um verschiedene Zyantöne handelt. Beachten Sie, dass die Einstellungen als Hashtabelle übergeben werden.

$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

Hinweis

Vor der Veröffentlichung der SPO-Verwaltungsshell im Dezember 2017 musste das Cmdlet "Add-SPOTheme " die Farbpaletteneinstellungen als Wörterbuch übergeben. Es wird empfohlen, dass Sie die neueste Version der SPO-Verwaltungsshell verwenden oder die HashToDictionary Funktion verwenden, um bei Bedarf eine Hashtabelle in ein Wörterbuch zu konvertieren.

Beispiel 2

Wenn Sie ein vorhandenes Design aktualisieren möchten (um z. B. einige seiner Farbeinstellungen zu ändern), verwenden Sie die gleiche Syntax wie zuvor gezeigt, fügen Sie das -Overwrite Kennzeichen jedoch dem Cmdlet "Add-SPOTheme " hinzu.

Add-SPOTheme -Identity "Custom Cyan" -Palette $themepalette -IsInverted $false -Overwrite

Parameter

-Identity

Gibt den Namen des Designs an. Dadurch muss das Design eindeutig identifiziert werden.

Type:SpoThemePalettePipeBind
Aliases:Name
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-IsInverted

Gibt an, ob das Design invertiert wird, mit einem dunklen Hintergrund und einem hellen Vordergrund.

Type:Boolean
Aliases:None
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-Palette

Gibt die Farbpalette im Design als Wörterbuch mit Designplatzwerten an.

Type:SpoThemePalettePipeBind
Aliases:None
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-Überschreiben

Überschreibt ein Design mit demselben Namen für den Fall, dass es vorhanden ist.

Type:SwitchParameter
Aliases:None
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online