Migrationseignungsscan: Lange OneDrive-URLs
Informationen zur Behebung von Problemen mit langen OneDrive-URLs während der Migration.
Übersicht
Wenn Sie eine OneDrive-Website von Ihrer Quelle in die Zielumgebung verschieben, ändert die OneDrive-URL die Formate. Auf der Quellplattform weisen die OneDrive-Websites das Format auf https://onedrive.contoso.com/personal/domain_user. Auf der Zielplattform ändert sich der Domain_User Teil der URL, um den UPN für den Benutzer zu verwenden. Dies sieht ähnlich https://onedrive.contoso.com/personal/user_contoso_comwie aus.
Beispiel:
Wenn Sie die folgende Datei verwendet haben,
https://OneDrive.contoto.com/personal/contoso_bobsmith/Documents/Folder1/Folder2/ProjectA.docx
lautet der Verzeichnisname der Datei wie folgt:
Personal/contoso_bobsmith/Documents/Folder1/Folder2
Hinweis
Der Verzeichnispfad einer Datei in SharePoint ist auf 400 Zeichen begrenzt.
Nach der Migration sieht der Dateipfad wie folgt aus:
Personal/bobsmith_contoso_com/Documents/Folder1/Folder2
Beachten Sie, dass die URL jetzt vier Zeichen länger als zuvor ist. Je nachdem, wie die UPNs in Ihrem Unternehmen gebildet werden, kann die Längenänderung größer sein.
Wenn die vorherige Datei in der Quellumgebung 255 Zeichen aufwies, würde die Länge nach der Migration 259 Zeichen umfassen.
Wir haben vier verschiedene Speicherorte identifiziert, an denen aufgrund langer URLs wahrscheinlich Fehler auftreten. Daher haben wir vier verschiedene Berichte zu langen URLs. Im Abschnitt Überprüfungsergebnisberichte werden die einzelnen Berichte zusammen mit der korrektur behandelt, die durchgeführt werden muss.
Datenmigration
Die Migration des Quellinhalts, die zu den langen URLs führt, schlägt fehl. Dies führt dazu, dass Migrationsaufträge fehlschlagen, wodurch das Migrationsprojekt unnötig verlängert wird.
Wichtig
Jede Website, die in SharePoint als "Kein Zugriff" (gesperrt) konfiguriert ist, wird übersprungen. Eine Liste der gesperrten Websitesammlungen finden Sie in der Scanausgabe gesperrter Websites.
Vorbereiten der Migration
Überprüfen Sie die Berichte, und befolgen Sie die für jeden Bericht empfohlenen Korrekturen. Im Allgemeinen umfasst die Korrektur das Verschieben des Inhalts näher an den Stamm der Websitesammlung.
Nach der Migration
Überprüfen Sie, ob der Inhalt migriert wurde.
Ergebnisberichte des Scans
Dieser Scan führt zu vier Ausgabedateien. Jede Datei ist für ein bestimmtes Problem mit langen URLs vorgesehen, das zu Migrationsfehlern führt. LongODBUrl-AllDocs-detail.csv Es gibt zwei Einschränkungen im Zusammenhang mit der Länge des Pfads zu einer bestimmten Datei:
Der relative Serverpfad zu dem Ordner, der die Datei enthält, hat maximal 400 Zeichen. Verwenden Sie die folgende Beispieldatei:
https://OneDrive.contoto.com/Personal/contoso_bobsmith/Documents/Folder1/Folder2/ProjectA.docxDer Verzeichnisname lautet wie folgt:
Personal/contoso_bobsmith/Documents/Folder1/Folder2.Nach der Migration sieht der Dateipfad wie folgt aus: Beachten Sie, dass die URL jetzt länger ist als zuvor:
Personal/bobsmith_contoso_com/Documents/Folder1/Folder2.Der relative Serverpfad zu einer Datei oder einem Ordner hat maximal 400 Zeichen. Verwenden Sie die folgende Beispieldatei:
https://OneDrive.contoto.com/Personal/contoso_bobsmith/Documents/Folder1/Folder2/ProjectA.docxDer relative Serverpfad zur Datei sieht in etwa wie folgt aus: Personal/contoso_bobsmith/Documents/Folder1/Folder2/ProjectA.docx
Wenn in diesem Bericht Dateien aufgeführt sind, müssen die Besitzer die Dateien in kürzere Pfade verschieben oder die Dateien löschen. Beispielsweise könnten sie ProjectA.docx direkt in einen Ordner unter Dokumente verschieben oder die Datei löschen, wenn sie nicht mehr benötigt wird.
| Spalte | Beschreibung |
|---|---|
| SiteId | Der eindeutige Bezeichner der betroffenen Websitesammlung |
| SiteURL | Die URL der betroffenen Websitesammlung |
| SiteOwner | Der Besitzer der Websitesammlung |
| SiteAdmins | Liste der Personen, die als Administratoren der Websitesammlung aufgeführt werden. |
| SiteSizeInMB | Größe der Websitesammlung in Megabyte [MB] |
| NumOfWebs | Die Anzahl von Websites, die in der Websitesammlung vorhanden sind. |
| ContentDBName | Der Name der Inhaltsdatenbank, in der die Websitesammlung gehostet wird. |
| ContentDBServerName | SQL Server, der die Inhaltsdatenbank hostet. |
| ContentDBSizeInMB | Die Größe der Inhaltsdatenbank, in der die Websitesammlung gehostet wird. |
| LastContentModifiedDate | Datum/Uhrzeit der letzten Änderung der Inhalte der Websitesammlung |
| TotalItemCount | Die Gesamtzahl von Elementen in der Websitesammlung |
| Hits | Die Anzahl der für die Websitesammlung protokollierten Anforderungen. Basiert auf Daten aus dem Verbrauchsprotokollierungsdienst. Wenn der Verwendungsprotokollierungsdienst deaktiviert ist, wird in dieser Zeile N/V angezeigt. |
| DistinctUsers | Anzahl unterschiedlicher Benutzer, die auf die Websitesammlung zugegriffen haben. Basiert auf Daten aus dem Verbrauchsprotokollierungsdienst. Wenn der Verwendungsprotokollierungsdienst deaktiviert ist, wird in dieser Zeile N/V angezeigt. |
| DaysOfUsageData | Anzahl der Tage, die der Nutzungsprotokollierungsdienst Daten beibehält. Dadurch wird Kontext für Hits und DistinctUsers bereitgestellt. Wenn dies z. B. 14 Tage sind, werden die Daten hits und DistinctUsers für die letzten 14 Tage verwendet. |
| UPN | UPN, der verwendet wurde, um den Unterschied in der URL-Länge zu bestimmen. Wenn der UPN "****" lautet, gibt dies an, dass der Besitzer in ihrem SharePoint-Profil keinen UserPrincipalName festgelegt hat. Daher wurde die durchschnittliche Länge der UserPrincipalName-Werte im SharePoint-Profilspeicher verwendet. |
| URLLengthDifference | Betrag, den die URL wächst, wenn die Website umbenannt wird. |
| Datei | Die Datei, die korrigiert werden muss. |
| ScanID | Eindeutiger Bezeichner einer bestimmten Ausführung des SharePoint-Migrationseignungstools |
LongODBUrl-NavNodes-detail.csv Navigationsknoten haben eine URL-Längenbeschränkung von 260 Zeichen. Dies kann dazu führen, dass das URL-Feld die maximale Länge überschreitet.
Sie haben zum Beispiel eine OneDrive-Site unter https://OneDrive.contoso.com/personal/contoso_bobsmith. Diese Website hat einen Link in der Schnellstartleiste mit dem Namen Berichte und die URL des Links verweist auf https://onedrive.contoso.com/personal/contoso_bobsmith/documents/folder1/...folderN/Reports. Während der Migration aktualisiert SharePoint die URL so, dass sie auf /bobsmith_contoso_com/verweist. Die zusätzliche Länge, die der URL hinzugefügt wird, kann dazu führen, dass die Länge mehr als 260 Zeichen beträgt, was dazu führt, dass die Migration fehlschlägt.
Um dieses Problem zu beheben, würden Sie den Ordner reports in die Nähe des Stammverzeichnisses der Bibliothek /documents/ verschieben und dann den Schnellstartlink aktualisieren. Eine weitere Möglichkeit wäre das Entfernen des Schnellstartlinks.
| Spalte | Beschreibung |
|---|---|
| SiteId | Der eindeutige Bezeichner der betroffenen Websitesammlung |
| SiteURL | Die URL der betroffenen Websitesammlung |
| SiteOwner | Der Besitzer der Websitesammlung |
| SiteAdmins | Liste der Personen, die als Administratoren der Websitesammlung aufgeführt werden. |
| SiteSizeInMB | Größe der Websitesammlung in Megabyte [MB] |
| NumOfWebs | Die Anzahl von Websites, die in der Websitesammlung vorhanden sind. |
| ContentDBName | Der Name der Inhaltsdatenbank, in der die Websitesammlung gehostet wird. |
| ContentDBServerName | SQL Server, der die Inhaltsdatenbank hostet. |
| ContentDBSizeInMB | Die Größe der Inhaltsdatenbank, in der die Websitesammlung gehostet wird. |
| UPN | UPN, der verwendet wurde, um den Unterschied in der URL-Länge zu bestimmen. Wenn der UPN "****" lautet, gibt dies an, dass der Besitzer in ihrem SharePoint-Profil keinen UserPrincipalName festgelegt hat. Daher wurde die durchschnittliche Länge von UserPrincipalName im SharePoint-Profilspeicher verwendet. |
| URLLengthDifference | URLLengthDifference Amount the URL wächst, wenn die Website umbenannt wird. |
| WebURL | Die URL der Website mit dem Navigationsknoten |
| NavigationNodeLocation | Navigationsknotentitel, die zeigen, wo sich der Navigationsknoten befindet. Sie können über mehrere Ebenen von Navigationsknoten verfügen, um den problematischen Knoten zu finden. |
| NavigationNodeTitle | Der Titel des betroffenen Navigationsknotens |
| NavigationNodeURL | Die URL, die nach der Umbenennung der Website zu lang ist |
| ScanID | Eindeutiger Bezeichner einer bestimmten Ausführung des SharePoint-Migrationseignungstools |
LongODBUrl-Perms-detail.csv Berechtigungen, die für ein Objekt in SharePoint festgelegt werden, werden durch die URL dieses Objekts nachverfolgt. Wenn Sie Berechtigungen für einen Ordner festlegen, speichert SharePoint den relativen Pfad zum Ordner. Wenn Sie Berechtigungen für ein Element festlegen, speichert SharePoint den relativen Pfad des Servers zum Element.
Daher werden während einer Websitemigration die mit Berechtigungen verknüpften URLs aktualisiert. Dies kann zu Fehlern führen, wenn die neue URL zu lang ist.
Die Abhilfe hierfür besteht darin, das betroffene Objekt näher an den Stamm der Websitesammlung zu verschieben. Eine weitere Möglichkeit besteht darin, die unterschiedlichen Berechtigungen aus den Elementen im Bericht zu entfernen.
| Spalte | Beschreibung |
|---|---|
| SiteId | Der eindeutige Bezeichner der betroffenen Websitesammlung |
| SiteURL | Die URL der betroffenen Websitesammlung |
| SiteOwner | Der Besitzer der Websitesammlung |
| SiteAdmins | Liste der Personen, die als Administratoren der Websitesammlung aufgeführt werden. |
| SiteSizeInMB | Größe der Websitesammlung in Megabyte [MB] |
| NumOfWebs | Die Anzahl von Websites, die in der Websitesammlung vorhanden sind. |
| ContentDBName | Der Name der Inhaltsdatenbank, in der die Websitesammlung gehostet wird. |
| ContentDBServerName | SQL Server, der die Inhaltsdatenbank hostet. |
| ContentDBSizeInMB | Die Größe der Inhaltsdatenbank, in der die Websitesammlung gehostet wird. |
| UPN | UPN UserPrincipalName, der verwendet wurde, um den Unterschied in der URL-Länge zu bestimmen. Wenn der UPN "****" lautet, gibt dies an, dass der Besitzer in ihrem SharePoint-Profil keinen UserPrincipalName festgelegt hat. Daher wurde die durchschnittliche Länge von UserPrincipalName im SharePoint-Profilspeicher verwendet. |
| URLLengthDifference | Der Betrag wird größer, wenn die Website umbenannt wird. |
| WebURL | Die URL der Website, auf der das gesicherte Objekt gehostet wird |
| SecuredObject | Dies ist die URL zum geschützten Objekt, die nach dem Umbenennen der Website zu lang ist. Wenn Sie berechtigungen zu einer Datei hinzufügen, ist dies der relative Serverpfad zur Datei. Wenn Sie Berechtigungen für einen Ordner festlegen, ist dies der relative Serverpfad zum Ordner. |
| ScanID | Eindeutiger Bezeichner einer bestimmten Ausführung des SharePoint Migration Assessment Tool |
LongODBUrl-Deps-detail.csv Bestimmte Dateien können andere Abhängigkeiten aufweisen. Diese Abhängigkeiten werden über die URL nachverfolgt. Wenn die Abhängigkeitsinformationen während der Migration zu lang sind, schlägt die Migration fehl.
Es gibt zwei Einschränkungen in diesem Bericht, die zu beachten sind:
FullURL ist auf 260 Zeichen beschränkt. Dies ist die Datei mit den Abhängigkeiten. Wenn die FullURL zu lang ist, entfernen Sie entweder die Datei, oder verschieben Sie die Datei an einen Speicherort, der sich näher am Stamm der Websitesammlung befindet.
DependencyDescription ist auf 270 Zeichen beschränkt. Dies ist die Abhängigkeit, die der FullURL zugeordnet ist. Um die DependencyDescription zu korrigieren, entfernen Sie entweder die Abhängigkeit, oder verschieben Sie die Abhängigkeit näher an den Stamm der Websitesammlung.
| Spalte | Beschreibung |
|---|---|
| SiteId | Der eindeutige Bezeichner der betroffenen Websitesammlung |
| SiteURL | Die URL der betroffenen Websitesammlung |
| SiteOwner | Der Besitzer der Websitesammlung |
| SiteAdmins | Liste der Personen, die als Administratoren der Websitesammlung aufgeführt werden. |
| SiteSizeInMB | Größe der Websitesammlung in Megabyte [MB] |
| NumOfWebs | Die Anzahl von Websites, die in der Websitesammlung vorhanden sind. |
| ContentDBName | Der Name der Inhaltsdatenbank, in der die Websitesammlung gehostet wird. |
| ContentDBServerName | SQL Server, der die Inhaltsdatenbank hostet. |
| ContentDBSizeInMB | Die Größe der Inhaltsdatenbank, in der die Websitesammlung gehostet wird. |
| UPN | UPN, der verwendet wurde, um den Unterschied in der URL-Länge zu bestimmen. Wenn der UPN "****" lautet, gibt dies an, dass der Besitzer in ihrem SharePoint-Profil keinen UserPrincipalName festgelegt hat. Daher wurde die durchschnittliche Länge von UserPrincipalName im SharePoint-Profilspeicher verwendet. |
| URLLengthDifference | Der Betrag wird größer, wenn die Website umbenannt wird. |
| FullURL | Die URL der Datei mit Abhängigkeiten |
| DependencyDescription | DependencyDescription Beschreibung, die der Abhängigkeit zugeordnet ist. Dies kann eine URL sein, die umbenannt wird. |
| ScanID | Eindeutiger Bezeichner einer bestimmten Ausführung des SharePoint Migration Assessment Tool |
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für