Add-SPOTheme

  • Referenz
Modul:
Microsoft.Online.SharePoint.PowerShell
Gilt für::
SharePoint Online

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 entweder als Hashtabelle oder als Wörterbuch übergeben werden.

Durch das Hinzufügen eines Designs wird das Design nicht auf Websites angewendet. Das Design wird Ihrem Mandantenspeicher hinzugefügt, 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" erstellt, mit Farbpaletteneinstellungen, die verschiedene Zyan-Schattierungen sind. 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 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 2

Wenn Sie ein vorhandenes Design aktualisieren möchten (z. B. um einige seiner Farbeinstellungen zu ändern), verwenden Sie die gleiche Syntax wie zuvor gezeigt, fügen Sie das -Overwrite Flag 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
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-IsInverted

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

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

-Overwrite

Überschreibt ein Design mit demselben Namen, falls es vorhanden ist.

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

-Palette

Gibt die Farbpalette im Design als Wörterbuch von Designslotwerten an.

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