Transformieren klassischer SharePoint-Seiten in moderne Seiten

Dieser primäre Workflow transformiert klassische Wiki- und Webpartseiten in der Standardbibliothek SitePages in SharePoint Online. Verwenden Sie das Microsoft 365-Bewertungstool, um Seiten und ihre Webparts zu identifizieren, und verwenden Sie dann PnP PowerShell, um genehmigte Seiten zu transformieren und jedes Ergebnis zu überprüfen, bevor sie eine größere Welle verarbeiten.

Veröffentlichungsseiten, Blogseiten, Seiten außerhalb SitePagesvon , Startseiten und SharePoint Server-Quellen erfordern separate erweiterte Verfahren und werden von den Seitenwellenskripts nicht akzeptiert.

Dieser Workflow verwendet PnP PowerShell als primären Ausführungspfad. Die Seitentransformations-Engine ist Teil des Open-Source-PnP-Frameworks und verfügt nicht über eine Microsoft-Support-SLA.

Seitentransformationsworkflow

  1. Wählen Sie eine repräsentative Seitenwelle aus der abgeschlossenen Bewertungsabdeckung aus.
  2. Beheben Sie blockierende Webparts, und wählen Sie ein direktes oder websiteübergreifendes Ziel aus.
  3. Bereiten Sie eine mandanteneigene PnP-PowerShell-Anwendung und die erforderlichen Berechtigungen vor.
  4. Transformieren Sie die repräsentative Welle mit quellenerhaltenden Standardwerten und Protokollierungen.
  5. Überprüfen Sie jede generierte Seite, bevor Sie die Welle erweitern.

1. Auswählen von Seitenkandidaten

Beginnen Sie mit einer abgeschlossenen Bewertung klassischer Seiten. Bestätigen Sie die Scanabdeckung, bevor Sie Seiten auswählen.

Für die erste Welle:

  • Wählen Sie WikiPage oder WebPartPage Zeilen aus erfolgreichen Website- und Webscans aus.
  • Bevorzugen Sie Seiten ohne nicht zugeordnete Webparts und einen hohen Zuordnungsprozentsatz.
  • Überprüfen Sie classicpagewebparts.csv die genauen Webparttypen und Zuordnungen.
  • Überprüfen Sie manuell jede Seite mit WebPartCount=0. Ein Zuordnungsprozentsatz von 100 für eine nullteilige Seite bedeutet nur, dass die Bewertung keine Webparts extrahiert hat.
  • Vermeiden Sie eine Startseite, bis sich der Transformations- und Validierungsprozess bewährt hat.
  • Zeichnen Sie sichtbaren Text, Webparts, Links, Bilder und Layouts auf, die nach der Transformation vorhanden sein müssen.

MappingPercentage=100 ist ein Planungssignal. Es ist nicht garantiert, dass die Transformation erfolgreich ausgeführt wird oder der erwartete Inhalt erhalten bleibt.

Erstellen einer repräsentativen Welle

Behandeln Sie Seiten nur dann als dasselbe Transformationsmuster, wenn diese Dimensionen übereinstimmen:

Dimension Gründe für die Definition eines separaten Musters
PageType Trennt das Transformationsverhalten von Wiki und Webpart.
Layout Steuert die generierten Abschnitte und Spalten.
Geordnete Webpartsignatur Seiten mit unterschiedlichen Webparttypen, Reihenfolge, ausgeblendetem oder geschlossenem Zustand können unterschiedlich transformiert werden.
Zuordnungsergebnis Nicht zugeordnete oder anders zugeordnete Webparts erfordern separate Korrekturen und Überprüfungen.
Zielansatz Direkte und websiteübergreifende Transformationen weisen unterschiedliche Abhängigkeits- und URL-Verhalten auf.
Spezielle Handhabung Homepages, benutzerdefinierte Veröffentlichungslayouts und nullteilige Seiten erfordern eine separate Überprüfung.

Verwenden Sie classicpagewebparts.csv , um die geordnete Webpartsignatur für jede Seite zu erstellen. Gruppieren Sie nicht nur nach MappingPercentage oder UnmappedWebParts. Vollständig zugeordnete Seiten können weiterhin unterschiedliche Webparttypen und das Laufzeitverhalten enthalten.

Für die erste Welle:

  1. Schließen Sie eine fehlerhafte Abdeckung, nicht unterstützte Seitentypen, Startseiten, nullteilige Seiten und nicht aufgelöste Zuordnungen aus.
  2. Gruppiert die verbleibenden Seiten nach Seitentyp, Layout und geordneter Webpartsignatur.
  3. Wählen Sie mindestens eine Seite aus jedem Muster aus, das Sie migrieren möchten.
  4. Fügen Sie einen weiteren Vertreter hinzu, wenn Seiten im selben Muster wesentlich unterschiedliche Webparteigenschaften oder Inhaltsabhängigkeiten verwenden.
  5. Bevorzugen Sie eine Seite mit einer klaren Inhaltsbaseline und einen Geschäftsinhaber, der das Ergebnis überprüfen kann.

Verwenden Sie Aktivitäts- und Änderungsdaten, um zu priorisieren, welches Muster zuerst verarbeitet werden soll, nicht als Ersatz für die Musterabdeckung.

Weitere Informationen finden Sie unter Erstellen repräsentativer Seitengruppen mit PowerShell.

Informationen zur Zuordnung von Feld zu Befehl und ein Beispiel für ausgewählte Seiten finden Sie unter Interpretieren des Bewertungsberichts für klassische Seiten.

2. Auflösen von Blockern und Auswählen des Ziels

Gruppieren Sie Kandidatenseiten nach Seitentyp, Layout und nicht zugeordneter Webpartkombination. Lösen Sie häufige Blocker auf, bevor Sie eine Welle transformieren.

  • Für Wiki- und Webpartseiten ist die direkte Transformation der bevorzugte Ausgangspunkt, da Abhängigkeiten auf der Quellwebsite verbleiben.
  • Websiteübergreifende Wiki- und Webparttransformationen erfordern eine zusätzliche Überprüfung für Links, Dateien, Listen, Benutzer und Taxonomie.

Weitere Informationen finden Sie unter Auswählen einer direkten oder websiteübergreifenden Transformation und Überprüfen von klassischen Webpartzuordnungen.

3. Vorbereiten von PnP PowerShell

PnP PowerShell erfordert eine mandanteneigene Microsoft Entra-Anwendung. Verwenden Sie eine separate Transformationsanwendung von der schreibgeschützten Bewertungsanwendung.

Verwenden Sie für den primären interaktiven Flow delegiertes SharePoint AllSites.Managezusammen mit den vorhandenen Websiteberechtigungen des angemeldeten Benutzers. Das Kopieren eindeutiger Berechtigungen auf Elementebene erfordert AllSites.FullControl; andernfalls wird diese Kopie explizit übersprungen.

Folgen Sie den Anweisungen zum Transformieren ausgewählter Seiten mit PnP PowerShell , um die Anwendung zu registrieren, eine Verbindung herzustellen und die erste Transformation auszuführen.

4. Transformieren einer repräsentativen Welle

Transformieren Sie eine kleine Welle, die die Seitentypen, Layouts und Webpartkombinationen darstellt, die Sie verarbeiten möchten.

Für die erste Welle:

  • Lassen Sie die generierte Seite das Standardpräfix Migrated_ verwenden.
  • Verwenden -TakeSourcePageName-OverwriteSie keine Optionen für die Ersetzung von , oder der Startseite.
  • Aktivieren Sie die Dateiprotokollierung, und behalten Sie das Protokoll mit dem Wellenmanifest bei.
  • Beenden Sie beim ersten unerwarteten Fehler oder Inhaltskonflikt.

Aktivieren Sie das Quellumbenennungs- oder Überschreibungsverhalten erst, nachdem die generierten Seiten genehmigt wurden und ein Rollbackplan vorhanden ist.

Verwenden Sie die eingebetteten Skripts aus der Seitenwellenskriptreferenz , um jede genehmigte repräsentative Seite über denselben Sicherheits- und Ergebnisvertrag zu verarbeiten.

5. Überprüfen und erweitern

Das Öffnen ohne Fehler reicht nicht aus. Eine generierte Seite kann vorhanden sein und weiterhin leer oder unvollständig sein.

Überprüfen Sie die Quelle und die generierte Seite, das Transformationsprotokoll, den Inhalt, webparts, das Layout, Links, Bilder, Metadaten, Berechtigungen und den Veröffentlichungsstatus. Erweitern Sie die Welle nur, wenn jede ausgewählte Seite die Akzeptanzkriterien erfüllt.

Weitere Informationen finden Sie unter Überprüfen von transformierten klassischen Seiten.

Nachdem jedes repräsentative Ergebnis markiert Passedist, verwenden Sie Convert-SelectedPages.ps1 , um alle zusätzlichen vom Benutzer genehmigten Zeilen zu verarbeiten. Das Skript lehnt Seiten ab, deren Transformationsmuster keinen übergebenen Vertreter aufweist.

Nächste Schritte

  1. Transformieren ausgewählter Seiten mit PnP PowerShell.
  2. Überprüfen Sie die transformierten Seiten.

Erweiterte Referenz

  • Last updated on