PnP PowerShell: Abhängigkeit von Profilsprache

Bei der Arbeit mit PnP-PowerShell kann es zu unerwarteten Problemen aufgrund der Spracheinstellungen kommen. In diesem Beitrag erfährst du, warum die Profilsprache entscheidend ist und wie du sprachabhängige Schwierigkeiten effektiv vermeiden kannst.

Das Problem

Während verschiedener Kundenprojekte trat ein schwer erklärbares Problem auf: „Manchmal" zeigten PnP-Befehle nicht das erwartete Verhalten. Beispielsweise konnte ein Entwickler die Beschreibung einer SharePoint-Seite erfolgreich aktualisieren, jedoch waren die Änderungen für andere Nutzer nicht sichtbar! Zudem wurden beim Export eines Seiten-Templates mit Get-PnPSiteTemplate die Namen von Dokumentenbibliotheken, Feldern und Ansichten auf Englisch gespeichert, obwohl die Website auf Deutsch eingestellt war.

Die Ursache

Beide Probleme teilen die gleiche Ursache: PnP-Befehle sind abhängig von der Sprache des Benutzers, der das PnP-Script ausführt. Die Sprache wird nicht von der Website-Einstellung bestimmt, sondern vom Microsoft 365 Benutzerprofil des ausführenden Nutzers.

Welche Sprache ist gemeint? SharePoint, Browser oder Benutzerprofil?

Die entscheidende Sprache ist nicht die SharePoint-Website-Sprache und auch nicht die Browser-Sprache. Entscheidend ist die Sprache des Microsoft 365 Benutzerprofils. Diese wird in den Profileinstellungen definiert und bestimmt, wie PnP PowerShell Felder, Bibliotheken und Ansichten benennt.

Die Lösung: Probleme vermeiden

Mit diesem Wissen lassen sich sprachabhängige Probleme gezielt vermeiden.

Schritt 1: Profilsprache überprüfen

Bevor du ein Update an sprachabhängigen Feldern vornimmst oder ein Website-Template exportierst, überprüfe deine Microsoft 365 Profilsprache. Die Sprache in deinem Profil bestimmt, wie PnP PowerShell alle Feldnamen, Bibliotheksnamen und Ansichten benennt.

Schritt 2: Profileinstellung vor Exports anpassen

Möchtest du beispielsweise ein Seiten-Template für eine deutsche Website exportieren, stelle sicher, dass dein Benutzerprofil auf Deutsch eingestellt ist, bevor du Get-PnPSiteTemplate ausführst. Auf diese Weise werden alle Dokumentenbibliotheken, Felder und Ansichten auf Deutsch exportiert und können korrekt in die Ziel-Website importiert werden.

Schritt 3: Updates mit konsistenter Sprache durchführen

Bei Seiten-Beschreibungen und anderen mehrsprachigen Feldern ist Vorsicht geboten. Wenn du beispielsweise eine Seitenbeschreibung mit PnP PowerShell aktualisierst und dein Profil auf Englisch eingestellt ist, wird nur die englische Version des Feldes geändert - nicht die deutsche. Nutzer mit deutschem Profil sehen die Änderung nicht.

Best Practice: Verwende das gleiche Benutzerprofil (mit korrekter Spracheinstellung) für alle verwandten Operationen. Vorsicht ist besonders wichtig, wenn mehrere Entwickler an der gleichen SharePoint-Umgebung arbeiten.

Zusammenfassung

Beim Einsatz von PnP PowerShell ist es essenziell, die Sprache des Microsoft 365 Benutzerprofils des ausführenden Nutzers zu berücksichtigen. Sprachkonflikte entstehen nicht durch Website-Einstellungen oder Browser-Sprache, sondern durch eine Abweichung zwischen Profilsprache und Zielsprache.

Merksatz: Profile-Sprache = Template-Sprache = Konsistenz

Benötigst du Unterstützung?

Sprachabhängige Fehler bei PnP PowerShell oder komplexe SharePoint-Automatisierungen gehören zu unserer täglichen Arbeit. Unser Team berät dich gerne bei SharePoint-Migrations- und Automatisierungsprojekten.

Vereinbare ein kostenfreies Erstgespräch - wir helfen dir, sprachabhängige Fehler zu vermeiden und deine PnP-PowerShell-Prozesse sicher zu gestalten.