Analisi di valutazione della migrazione: URL di OneDriveMigration Assessment Scan: Long OneDrive URLs

Informazioni su come risolvere i problemi relativi agli URL di OneDrive durante la migrazione.Learn how to fix issues with long OneDrive URLs during migration.

PanoramicaOverview

Quando si sposta un sito di OneDrive dall'ambiente di origine a quello di destinazione, l'URL di OneDrive cambierà i formati. Nella piattaforma di origine i siti di OneDrive sono in formato https://onedrive.contoso.com/personal/domain_user. Nella piattaforma di destinazione la parte utente_dominio dell'URL viene modificata per usare l'UPN dell'utente. Sarà simile a https://onedrive.contoso.com/personal/user_contoso_com.When you're moving a OneDrive site from your source to the target environment, the OneDrive URL will change formats. On the source platform the OneDrive sites are in the format of https://onedrive.contoso.com/personal/domain_user. On the target platform, the Domain_User portion of the URL will change to use the UPN for the user. This will look similar to https://onedrive.contoso.com/personal/user_contoso_com.

Esempio:Example:

Se è stato usato il file:If you used this file:

https://OneDrive.contoto.com/personal/contoso_bobsmith/Documents/Folder1/Folder2/ProjectA.docx

Il nome della directory del file sarà:The directory name of the file would be:

  • Personale/contoso_mattiatrentini/Documenti/Cartella1/Cartella2Personal/contoso_bobsmith/Documents/Folder1/Folder2

Nota

Esiste un limite di 400 caratteri per il percorso directory di un file in SharePoint.There is a 400-character limit on the directory path to a file in SharePoint.

Dopo la migrazione, il percorso file risulterà analogo al seguente.After the migration, the file path will look like the following.

Personale/matteotrentini_contoso_com/Documenti/Cartella1/Cartella2Personal/bobsmith_contoso_com/Documents/Folder1/Folder2

L'URL ora è di quattro caratteri più lungo rispetto a prima. A seconda di come vengono formati gli UPN nella società, la modifica alla lunghezza potrebbe essere maggiore.Notice the URL is now 4 characters longer than it was before. Depending on how the UPNs are formed at your company, the change in length may be larger.

Se il file precedente nell'ambiente di origine conteneva 255 caratteri, la lunghezza dopo la migrazione sarà di 259 caratteri.If the previous file in the source environment was 255 characters, the length after migration would be 259 characters.

Sono state identificate quattro diverse posizioni in cui è probabile che si verifichino errori dovuti agli URL lunghi. Di conseguenza, vengono creati quattro report relativi agli URL lunghi. La sezione Report dei risultati dell'analisi descrive ogni report insieme alla correzione da applicare.We have identified 4 different locations in which failures are likely to occur due to long URLs. As a result, we have 4 different reports concerning long URLs. The Scan Result Reports section covers each report along with the remediation that needs to occur.

Migrazione dei datiData Migration

La migrazione del contenuto di origine che causa gli URL lunghi non riuscirà. Di conseguenza, non riusciranno neanche i processi di migrazione e il progetto di migrazione risulterà inutilmente prolungato.The migration of the source content resulting in the long URLs will fail. This will cause migration jobs to fail, which will prolong the migration project unnecessarily.

Importante

Qualsiasi sito configurato come "Nessun accesso" (bloccato) in SharePoint verrà ignorato. Per visualizzare un elenco di raccolte siti bloccate, vedere l'output di analisi Siti bloccati.Any site that is configured as "No Access" (locked), in SharePoint will be skipped. To see a list of locked site collections see the Locked Sites scan output.

Preparazione per la migrazionePreparing for Migration

Esaminare i report e applicare la correzione consigliata per ogni report. In generale, la correzione comprende l'avvicinamento del contenuto alla radice della raccolta siti.Review the reports and follow the remediation recommended for each report. In general, the remediation involves moving the content closer to the root of the site collection.

Post-migrazionePost Migration

Verificare che sia stata eseguita la migrazione del contenuto.Validate that your content has been migrated.

Analizzare i report dei risultatiScan Result Reports

L'analisi produce quattro file di output. Ogni file riguarda uno specifico problema relativo agli URL lunghi che causa errori di migrazione. LongODBUrl-AllDocs-detail.csv Esistono due limitazioni per la lunghezza del percorso di un determinato file:This scan results in 4 output files. Each file is for a specific long URL issue that will result in migration failures. LongODBUrl-AllDocs-detail.csv There are two limitations related to the length of the path to a given file:

  • Il percorso relativo del server per la cartella che contiene il file può includere al massimo 400 caratteri. Se si usa il file di esempio seguente:The server relative path to the folder containing the file has a maximum of 400 characters. Using the following example file:

    https://OneDrive.contoto.com/Personal/contoso_bobsmith/Documents/Folder1/Folder2/ProjectA.docx

    Il nome della directory sarà: Personale/contoso_mattiatrentini/Documenti/Cartella1/Cartella2The directory name would be the following: Personal/contoso_bobsmith/Documents/Folder1/Folder2

    Dopo la migrazione, il percorso del file risulterà analogo al seguente. L'URL ora è più lungo rispetto a prima: Personale/mattiatrentini_contoso_com/Documenti/Cartella1/Cartella2After the migration, the file path will look like the following. Notice the URL is now longer than it was before: Personal/bobsmith_contoso_com/Documents/Folder1/Folder2

  • Il percorso relativo del server per un file o una cartella può includere al massimo 400 caratteri. Se si usa il file di esempio seguente:The server relative path to a file or folder has a total maximum of 400 characters. Using the following example file:

    https://OneDrive.contoto.com/Personal/contoso_bobsmith/Documents/Folder1/Folder2/ProjectA.docx

    Il percorso del server relativo del file sarà simile al seguente: Personale/contoso_mattiatrentini/Documenti/Cartella1/Cartella2/ProgettoA.docxThe server relative path to the file will look similar to the following: Personal/contoso_bobsmith/Documents/Folder1/Folder2/ProjectA.docx

Se sono elencati file in questo report, i proprietari dovranno spostare i file in percorsi più brevi o eliminarli. Ad esempio, possono spostare ProgettoA.docx in una cartella contenuta direttamente in Documenti o eliminare il file se non è più necessario.If there are files listed in this report, the owners will need to move the files to shorter paths or delete the files. For example, they could move ProjectA.docx up to a folder directly under Documents, or they could delete the file if it is no longer needed.

ColonnaColumn DescrizioneDescription
SiteIdSiteId
Identificatore univoco della raccolta siti interessata.Unique identifier of the impacted site collection.
SiteURLSiteURL
URL della raccolta siti interessata.URL to the impacted site collection.
SiteOwnerSiteOwner
Proprietario della raccolta siti.Owner of the site collection.
SiteAdminsSiteAdmins
Elenco di utenti indicati come amministratori della raccolta siti.List of people listed as site collection administrators.
SiteSizeInMBSiteSizeInMB
Dimensioni della raccolta siti in megabyte [MB]Size of the size collection in megabytes [MB]
NumOfWebsNumOfWebs
Numero di Web esistenti nella raccolta siti.Number of webs that exist in the site collection.
ContentDBNameContentDBName
Nome del database del contenuto che ospita la raccolta siti.Name of the content database hosting the site collection.
ContentDBServerNameContentDBServerName
Sistema SQL Server che ospita il database del contenuto.SQL Server hosting the content database.
ContentDBSizeInMBContentDBSizeInMB
Dimensioni del database del contenuto che ospita la raccolta siti.Size of the content database hosting the site collection.
LastContentModifiedDateLastContentModifiedDate
Data/ora di modifica del contenuto della raccolta siti.Date/Time the site collection had content modified.
TotalItemCountTotalItemCount
Numero totale di elementi trovati nella raccolta siti.Total number of items found in the site collection.
HitsHits
Numero di richieste registrate per la raccolta siti. Si basa sui dati del servizio di registrazione dei dati di utilizzo. Se il servizio di registrazione dei dati di utilizzo è disabilitato, questa riga mostrerà N/D.Number of requests logged for the site collection. Relies on data from the usage logging service. If the usage logging service is disabled this row will show N/A.
DistinctUsersDistinctUsers
Numero di utenti distinti che hanno eseguito l'accesso alla raccolta siti. Si basa sui dati del servizio di registrazione dei dati di utilizzo. Se il servizio di registrazione dei dati di utilizzo è disabilitato, questa riga mostrerà N/D.Number of distinct users that have accessed the site collection. Relies on data from the usage logging service. If the usage logging service is disabled this row will show N/A.
DaysOfUsageDataDaysOfUsageData
Numero di giorni per cui il servizio di registrazione dei dati di utilizzo conserva i dati. Fornisce il contesto per Hits e DistinctUsers. Ad esempio, se corrisponde a 14 giorni, i dati di Hits e DistinctUsers riguardano gli ultimi 14 giorni.Number of days the usage logging service retains data. This provides context for Hits and DistinctUsers. For example, if this is 14 days, the Hits and DistinctUsers data is for the last 14 days.
UPNUPN
UPN usato per determinare la differenza di lunghezza dell'URL. Se UPN è "****", il proprietario non ha impostato UserPrincipalName nel profilo di SharePoint. Di conseguenza, è stata usata la lunghezza media dei valori UserPrincipalName nell'archivio profili di SharePoint.UPN that was used to determine the difference in the URL length. If the UPN is "****" that indicates the owner did not have a UserPrincipalName set in their SharePoint profile. As a result, the average length of the UserPrincipalName values in the SharePoint profile store was used.
URLLengthDifferenceURLLengthDifference
Entità dell'aumento dell'URL quando il sito viene rinominato.Amount the URL will grow when the site is renamed.
FileFile
File da correggere.File that needs to be remediated.
ScanIDScanID
Identificatore univoco assegnato a una specifica esecuzione dello strumento di valutazione della migrazione di SharePoint.Unique identifier assigned to a specific execution of the SharePoint Migration Assessment Tool.

LongODBUrl-NavNodes-Detail I nodi di navigazione hanno un limite di lunghezza dell'URL di 260 caratteri. Questo può causare che il campo dell'URL superi la lunghezza massima.LongODBUrl-NavNodes-detail.csv Navigation nodes have a URL length limitation of 260 characters. This can lead to the URL field exceeding the maximum length.

Ad esempio, un sito di OneDrive è disponibile in https://OneDrive.contoso.com/personal/contoso_bobsmith. Questo sito ha un collegamento nella barra di avvio veloce denominato Report e l'URL del collegamento punta a https://onedrive.contoso.com/personal/contoso_bobsmith/documents/folder1/…cartellaN/Report. Durante la migrazione, SharePoint aggiorna l'URL in modo che punti a /matteotrentini_contoso_com/. La lunghezza aggiunta all'URL può comportare il superamento del limite di 260 caratteri, causando il mancato completamento della migrazione.For example, you have a OneDrive site at https://OneDrive.contoso.com/personal/contoso_bobsmith. That site has a link in the Quick launch named Reports and the URL of the link points to https://onedrive.contoso.com/personal/contoso_bobsmith/documents/folder1/…folderN/Reports. During the migration, SharePoint will update the URL to point to /bobsmith_contoso_com/. The additional length added to the URL may result in the length being over 260 characters, which will cause the migration to fail.

Per risolvere questo problema, è possibile spostare la cartella dei report vicino alla radice della raccolta /documents/, quindi aggiornare il collegamento nella barra di avvio veloce. In alternativa, è possibile rimuovere il collegamento nella barra di avvio veloce.To remediate this issue, you would move the reports folder close to the root of the /documents/ library and then update the quick launch link. Another option would be to remove the quick launch link.

ColonnaColumn DescrizioneDescription
SiteIdSiteId
Identificatore univoco della raccolta siti interessata.Unique identifier of the impacted site collection.
SiteURLSiteURL
URL della raccolta siti interessata.URL to the impacted site collection.
SiteOwnerSiteOwner
Proprietario della raccolta siti.Owner of the site collection.
SiteAdminsSiteAdmins
Elenco di utenti indicati come amministratori della raccolta siti.List of people listed as site collection administrators.
SiteSizeInMBSiteSizeInMB
Dimensioni della raccolta siti in megabyte [MB]Size of the size collection in megabytes [MB]
NumOfWebsNumOfWebs
Numero di Web esistenti nella raccolta siti.Number of webs that exist in the site collection.
ContentDBNameContentDBName
Nome del database del contenuto che ospita la raccolta siti.Name of the content database hosting the site collection.
ContentDBServerNameContentDBServerName
Sistema SQL Server che ospita il database del contenuto.SQL Server hosting the content database.
ContentDBSizeInMBContentDBSizeInMB
Dimensioni del database del contenuto che ospita la raccolta siti.Size of the content database hosting the site collection.
UPNUPN
UPN usato per determinare la differenza di lunghezza dell'URL. Se UPN è "****", il proprietario non ha impostato UserPrincipalName nel profilo di SharePoint. Di conseguenza, è stata usata la lunghezza media di UserPrincipalName nell'archivio profili di SharePoint.UPN that was used to determine the difference in the URL length. If the UPN is "****" that indicates the owner did not have a UserPrincipalName set in their SharePoint profile. As a result, the average length of the UserPrincipalName in the SharePoint profile store was used.
URLLengthDifferenceURLLengthDifference
URLLengthDifference Entità dell'aumento dell'URL quando il sito viene rinominato.URLLengthDifference Amount the URL will grow when the site is renamed.
WebURLWebURL
URL della pagina Web che contiene il nodo di navigazione.URL to the web that has the navigation node.
NavigationNodeLocationNavigationNodeLocation
Titoli del nodo di navigazione che mostrano la posizione del nodo di navigazione. È possibile avere più livelli per i nodi di navigazione e ciò consente di individuare il nodo danneggiato.Navigation Node titles showing where the navigation node lives. You can have multiple levels of navigation nodes, and this will help locate the offending node.
NavigationNodeTitleNavigationNodeTitle
Titolo del nodo di navigazione interessato.Title of the impacted navigation node.
NavigationNodeURLNavigationNodeURL
L'URL che sarà troppo tempo dopo la ridenominazione del sito.URL that will be too long after the site rename.
ScanIDScanID
Identificatore univoco assegnato a una specifica esecuzione dello strumento di valutazione della migrazione di SharePoint.Unique identifier assigned to a specific execution of the SharePoint Migration Assessment Tool.

LongODBUrl-Perms-detail.csv Le autorizzazioni impostate su un oggetto in SharePoint vengono registrate con l'URL dell'oggetto. Se si impostano le autorizzazioni su una cartella, SharePoint archivierà il percorso relativo alla cartella. Se si impostano le autorizzazioni su un elemento, SharePoint archivierà il percorso relativo del server per l'elemento.LongODBUrl-Perms-detail.csv Permissions that are set on an object in SharePoint are tracked by the URL of that object. If you set permissions on a folder, SharePoint will store the relative path to the folder. If you set permissions on an item, SharePoint will store the server relative path to the item.

Di conseguenza, durante la migrazione di un sito gli URL associati alle autorizzazioni verranno aggiornati. Questo può causare errori se il nuovo URL è troppo lungo.As a result, during a site migration, the URLs associated with permissions will be updated. This may lead to failures if the new URL is too long.

La correzione per questo problema consiste nello spostare l'oggetto interessato più vicino alla radice della raccolta siti. In alternativa, è possibile rimuovere specifiche autorizzazioni dagli elementi nel report.The remediation for this is to move the affected object closer to the root of the site collection. Another option is to remove the distinct permissions from the items in the report.

ColonnaColumn DescrizioneDescription
SiteIdSiteId
Identificatore univoco della raccolta siti interessata.Unique identifier of the impacted site collection.
SiteURLSiteURL
URL della raccolta siti interessata.URL to the impacted site collection.
SiteOwnerSiteOwner
Proprietario della raccolta siti.Owner of the site collection.
SiteAdminsSiteAdmins
Elenco di utenti indicati come amministratori della raccolta siti.List of people listed as site collection administrators.
SiteSizeInMBSiteSizeInMB
Dimensioni della raccolta siti in megabyte [MB]Size of the size collection in megabytes [MB]
NumOfWebsNumOfWebs
Numero di Web esistenti nella raccolta siti.Number of webs that exist in the site collection.
ContentDBNameContentDBName
Nome del database del contenuto che ospita la raccolta siti.Name of the content database hosting the site collection.
ContentDBServerNameContentDBServerName
Sistema SQL Server che ospita il database del contenuto.SQL Server hosting the content database.
ContentDBSizeInMBContentDBSizeInMB
Dimensioni del database del contenuto che ospita la raccolta siti.Size of the content database hosting the site collection.
UPNUPN
UPN UserPrincipalName usato per determinare la differenza di lunghezza dell'URL. Se UPN è "****", il proprietario non ha impostato UserPrincipalName nel profilo di SharePoint. Di conseguenza, è stata usata la lunghezza media di UserPrincipalName nell'archivio profili di SharePoint.UPN UserPrincipalName that was used to determine the difference in the URL length. If the UPN is "****" that indicates the owner did not have a UserPrincipalName set in their SharePoint profile. As a result, the average length of the UserPrincipalName in the SharePoint profile store was used.
URLLengthDifferenceURLLengthDifference
Entità dell'aumento dell'URL quando il sito viene rinominato.Amount the URL will grow when the site is renamed.
WebURLWebURL
URL della pagina Web che ospita l'oggetto protetto.URL to the web hosting the secured object.
SecuredObjectSecuredObject
URL dell'oggetto protetto che sarà troppo lungo dopo la ridenominazione del sito. Se si aggiungono le autorizzazioni a un file, questo è il percorso relativo del server per il file. Se si impostano le autorizzazioni su una cartella, questo è il percorso relativo del server per la cartella.This is the URL to the secured object that will be too long after the site rename. If you add permissions to a file, this is the server relative path to the file. If you set permissions on a folder, this is the server relative path to the folder.
ScanIDScanID
Identificatore univoco assegnato a una specifica esecuzione dello strumento di valutazione della migrazione di SharePoint.Unique identifier assigned to a specific execution of the SharePoint Migration Assessment Tool.

LongODBUrl-Deps-detail.csv Alcuni file possono avere altre dipendenze. Le dipendenze vengono registrate con l'URL. Durante la migrazione, se le informazioni sulle dipendenze sono troppo lunghe, l'operazione non riuscirà.LongODBUrl-Deps-detail.csv Certain files can have additional dependencies. Those dependencies are tracked by the URL. During the migration if the dependency information is too long, the migration will fail.

Esistono due limitazioni nel report da tenere presenti:There are two limitations in this report to be aware of:

  • FullURL ha un limite di 260 caratteri. Si tratta del file con le dipendenze. Per risolvere il problema della lunghezza, rimuovere il file o spostarlo in un percorso più vicino alla radice della raccolta siti.FullURL has a limit of 260 characters. This is the file with the dependencies. To remediate if the FullURL is too long, either remove the file or move the file to a location closer to the root of the site collection.

  • DependencyDescription ha un limite di 270 caratteri. Si tratta della dipendenza associata a FullURL. Per risolvere il problema della lunghezza, rimuovere la dipendenza o spostarla in un percorso più vicino alla radice della raccolta siti.DependencyDescription has a limit of 270 characters. This is the dependency associated with the FullURL. To remediate the DependencyDescription, either remove the dependency or move the dependency closer to the root of the site collection.

ColonnaColumn DescrizioneDescription
SiteIdSiteId
Identificatore univoco della raccolta siti interessata.Unique identifier of the impacted site collection.
SiteURLSiteURL
URL della raccolta siti interessata.URL to the impacted site collection.
SiteOwnerSiteOwner
Proprietario della raccolta siti.Owner of the site collection.
SiteAdminsSiteAdmins
Elenco di utenti indicati come amministratori della raccolta siti.List of people listed as site collection administrators.
SiteSizeInMBSiteSizeInMB
Dimensioni della raccolta siti in megabyte [MB]Size of the size collection in megabytes [MB]
NumOfWebsNumOfWebs
Numero di Web esistenti nella raccolta siti.Number of webs that exist in the site collection.
ContentDBNameContentDBName
Nome del database del contenuto che ospita la raccolta siti.Name of the content database hosting the site collection.
ContentDBServerNameContentDBServerName
Sistema SQL Server che ospita il database del contenuto.SQL Server hosting the content database.
ContentDBSizeInMBContentDBSizeInMB
Dimensioni del database del contenuto che ospita la raccolta siti.Size of the content database hosting the site collection.
UPNUPN
UPN usato per determinare la differenza di lunghezza dell'URL. Se UPN è "****", il proprietario non ha impostato UserPrincipalName nel profilo di SharePoint. Di conseguenza, è stata usata la lunghezza media di UserPrincipalName nell'archivio profili di SharePoint.UPN that was used to determine the difference in the URL length. If the UPN is "****", that indicates the owner did not have a UserPrincipalName set in their SharePoint profile. As a result, the average length of the UserPrincipalName in the SharePoint profile store was used.
URLLengthDifferenceURLLengthDifference
Entità dell'aumento dell'URL quando il sito viene rinominato.Amount the URL will grow when the site is renamed.
FullURLFullURL
URL del file con le dipendenzeURL to the file that has the dependencies
DependencyDescriptionDependencyDescription
DependencyDescription - Descrizione associata alla dipendenza. Può trattarsi di un URL che viene rinominato.DependencyDescription Description associated with the dependency. This may be a URL that is getting renamed.
ScanIDScanID
Identificatore univoco assegnato a una specifica esecuzione dello strumento di valutazione della migrazione di SharePoint.Unique identifier assigned to a specific execution of the SharePoint Migration Assessment Tool.