SharePoint Online Themes mit PowerShell verwalten

SharePoint Online Themes mit PowerShell verwalten

🎯 Einleitung

Das visuelle Erscheinungsbild von SharePoint-Sites ist ein wichtiger Bestandteil der Benutzererfahrung und der Corporate Identity...

✅ Voraussetzungen

  1. SharePoint Online Management Shell ist installiert
  2. Administratorrechte für SharePoint Online
  3. Windows PowerShell 5.x
  4. Admin-URL: https://<Dein-Tenant-Name>-admin.sharepoint.com

🎨 Benutzerdefiniertes Theme erstellen

Nutze den Fluent UI Theme Designer oder die ältere Version UI Fabric Theme Designer und exportiere deine Farbenkombination. Füge die einzelnen Farben in das Script ein und führe es auf deiner Umgebung aus.


🎨 Benutzerdefiniertes Theme "Teamsware Purple" installieren

Alert
Achtung <Dein-Tenant-Namen> im Script nicht vergessen!


  1. # ⚠️ Dieses Skript muss in Windows PowerShell 5.x mit Adminrechten ausgeführt werden!

  3. # -----------------------------------------
  4. # Schritt 0: SharePoint Online Management Shell sicherstellen
  5. # -----------------------------------------
  6. if (-not (Get-Module -ListAvailable -Name Microsoft.Online.SharePoint.PowerShell)) {
  7.     Write-Host "SharePoint Online Management Shell wird installiert..." -ForegroundColor Cyan
  8.     Install-Module -Name Microsoft.Online.SharePoint.PowerShell -Scope CurrentUser -Force
  9. }

  11. Import-Module Microsoft.Online.SharePoint.PowerShell -ErrorAction Stop
  12. Write-Host "SharePoint Online PowerShell-Modul geladen." -ForegroundColor Green

  14. # -----------------------------------------
  15. # Schritt 1: Verbindung herstellen
  16. # -----------------------------------------
  17. $adminUrl = "https://<Dein_Tenant_Name>-admin.sharepoint.com"
  18. Write-Host "Verbinde mit: $adminUrl" -ForegroundColor Cyan
  19. Connect-SPOService -Url $adminUrl

  21. # -----------------------------------------
  22. # Schritt 2: Theme definieren
  23. # -----------------------------------------
  24. $themeName = "Teamsware Purple"

  26. $palette = @{
  27.   "themePrimary" = "#6667AB";
  28.     "themeLighterAlt" = "#f8f8fc";
  29.     "themeLighter" = "#e2e2f2";
  30.     "themeLight" = "#cacbe6";
  31.     "themeTertiary" = "#9b9ccd";
  32.     "themeSecondary" = "#7576b5";
  33.     "themeDarkAlt" = "#5c5d9a";
  34.     "themeDark" = "#4e4f82";
  35.     "themeDarker" = "#393a60";
  36.     "neutralLighterAlt" = "#faf9f8";
  37.     "neutralLighter" = "#f3f2f1";
  38.     "neutralLight" = "#edebe9";
  39.     "neutralQuaternaryAlt" = "#e1dfdd";
  40.     "neutralQuaternary" = "#d0d0d0";
  41.     "neutralTertiaryAlt" = "#c8c6c4";
  42.     "neutralTertiary" = "#a19f9d";
  43.     "neutralSecondary" = "#605e5c";
  44.     "neutralSecondaryAlt" = "#8a8886";
  45.     "neutralPrimaryAlt" = "#3b3a39";
  46.     "neutralPrimary" = "#323130";
  47.     "neutralDark" = "#201f1e";
  48.     "black" = "#000000";
  49.     "white" = "#ffffff"
  50. }

  52. # -----------------------------------------
  53. # Schritt 3: Bestehendes Theme sauber entfernen (optional)
  54. # -----------------------------------------
  55. Write-Host "Prüfe, ob Theme bereits existiert..." -ForegroundColor Cyan
  56. try {
  57.     Remove-SPOTheme -Name $themeName -ErrorAction Stop
  58.     Write-Host "Vorhandenes Theme '$themeName' wurde entfernt." -ForegroundColor Yellow
  59. }
  60. catch {
  61.     Write-Host "Kein existierendes Theme '$themeName' gefunden. Fahre fort..." -ForegroundColor Gray
  62. }

  64. # -----------------------------------------
  65. # Schritt 4: Theme hinzufügen
  66. # -----------------------------------------
  67. try {
  68.     Add-SPOTheme -Name $themeName -Palette $palette -IsInverted:$false -ErrorAction Stop
  69.     Write-Host "✔ Theme '$themeName' erfolgreich tenantweit registriert." -ForegroundColor Green
  70. }
  71. catch {
  72.     Write-Host "❌ Fehler beim Hinzufügen des Themes: $($_.Exception.Message)" -ForegroundColor Red
  73. }

🗑️ Einzelnes Theme löschen

  1. $adminUrl = "https://<Dein-Tenant-Name>-admin.sharepoint.com"
  2. Connect-SPOService -Url $adminUrl
  3. $themeName = "Teamsware Purple"
  4. Remove-SPOTheme -Name $themeName

🧹 Alle Themes löschen

  1. $adminUrl = "https://<Dein-Tenant-Name>-admin.sharepoint.com"
  2. Connect-SPOService -Url $adminUrl
  3. $themes = Get-SPOTheme
  4. foreach ($theme in $themes) {
  5.   Remove-SPOTheme -Name $theme.Name
  6. }

⚠️ Einschränkungen von Add-SPOTheme

Nur 32 Farbslots werden unterstützt
Erweiterte Semantic Slots wie
buttonBackground
werden automatisch berechnet

🧩 Verwendung von Theme-Tokens in SPFx

  1. .button {
  2.   background-color: "[theme: buttonBackground, default: #f3f2f1]";
  3.   color: "[theme: buttonText, default: #323130]";
  4. }

🔧 Tools & Ressourcen

📥 SharePoint Online Management Shell installieren

  1. PowerShell als Administrator öffnen
  2. Modul prüfen:
  3. Get-Module -ListAvailable -Name Microsoft.Online.SharePoint.PowerShell
  4. Modul installieren:
  5. Install-Module -Name Microsoft.Online.SharePoint.PowerShell -Scope CurrentUser -Force
  6. Modul importieren (optional):
  7. Import-Module Microsoft.Online.SharePoint.PowerShell
📌 Rechtlicher Hinweis
Hinweis: Die in diesem Artikel bereitgestellten Informationen und Skripte wurden mit größter Sorgfalt erstellt. Dennoch übernimmt die Teamsware GmbH keine Gewähr für die Aktualität, Richtigkeit und Vollständigkeit der Inhalte. Die Nutzung der bereitgestellten Informationen erfolgt auf eigene Verantwortung. Bitte teste alle Skripte vor dem produktiven Einsatz in einer geeigneten Testumgebung.