Give electronic files logical, specific names and include dates in file names if possible. The goal when naming files is to be able to tell what the file is about without having to open it and look. Altova MapForce is an easy-to-use, graphical data mapping tool for mapping, converting, and transforming XML, databases, flat files, JSON, EDI, Excel (OOXML), protobuf, and Web services. Simply drag and drop to map between different formats; then convert data instantly or choose from multiple automation options. We use cookies and related technologies to remember user preferences, for security, to analyse our traffic, and to enable website functionality.
The SharePoint Migration Tool (SPMT) is a tool that migrates your files from SharePoint on-premises document libraries or regular file shares and easily copies them to SharePoint in Microsoft 365. It is available to all Microsoft 365 users.
Download and install
Download and install SPMT using one of the links listed below.
Public preview | First release | General Availability |
---|---|---|
Install here | Install here | Install here |
Before you begin
Review the system requirements, settings, and permissions behavior before beginning your migration.
- SPMT prerequisites
- SPMT settings
- Understanding permissions when using the SharePoint Migration Tool
Important
- To migrate at the organization-level, you must be signed in as a global or SharePoint admin in Microsoft 365.
- To migrate at the site collection level, you must be a site admin.
Allow or prevent Custom Script (NoScript)
In Microsoft 365, tenants you can control whether users can run custom script on personal sites and self-service created sites.
During migration, some web parts require this setting set to allow. Otherwise, the web part will not be migrated.
At least 24 hours before you start migration, do the following:
Go to the Settings page of the new SharePoint admin center, and sign in with an account that has admin permissions for your organization.
Note
If you have Office 365 Germany, sign in to the Microsoft 365 admin center, then browse to the SharePoint admin center and open the Settings page.
If you have Office 365 operated by 21Vianet (China), sign in to the Microsoft 365 admin center, then browse to the SharePoint admin center and open the Settings page.At the bottom of the page, select classic settings page.
Under Custom Script, select:
Allow users to run custom script on personal sites
Allow users to run customer script on self-service created sitesLeave these settings in place for the duration of your migration.
Note
Changes to this setting might take up to 24 hours to take effect.
For more info, see, Allow or prevent custom script.
Note about logging in
When you first launch the SharePoint Migration Tool (SPMT), you are prompted for your Microsoft 365 username and password. The credentials you provide will be to the migration destination.
Authentication supported
SPMT supports the following authentication methods:
- NTLM
- Kerberos
- Forms
- ADFS
- Multi-factor authentication
- SAML-based claims
- Client certificate authentication
Important
If the on-premises server is configured to support multiple authentication providers, including Windows authentication, then Windows authentication will not be supported. If this describes your environment, use other authentication methods instead of Windows authentication.
Give electronic files logical, specific names and include dates in file names if possible. The goal when naming files is to be able to tell what the file is about without having to open it and look. Altova MapForce is an easy-to-use, graphical data mapping tool for mapping, converting, and transforming XML, databases, flat files, JSON, EDI, Excel (OOXML), protobuf, and Web services. Simply drag and drop to map between different formats; then convert data instantly or choose from multiple automation options. We use cookies and related technologies to remember user preferences, for security, to analyse our traffic, and to enable website functionality.
The SharePoint Migration Tool (SPMT) is a tool that migrates your files from SharePoint on-premises document libraries or regular file shares and easily copies them to SharePoint in Microsoft 365. It is available to all Microsoft 365 users.
Download and install
Download and install SPMT using one of the links listed below.
Public preview | First release | General Availability |
---|---|---|
Install here | Install here | Install here |
Before you begin
Review the system requirements, settings, and permissions behavior before beginning your migration.
- SPMT prerequisites
- SPMT settings
- Understanding permissions when using the SharePoint Migration Tool
Important
- To migrate at the organization-level, you must be signed in as a global or SharePoint admin in Microsoft 365.
- To migrate at the site collection level, you must be a site admin.
Allow or prevent Custom Script (NoScript)
In Microsoft 365, tenants you can control whether users can run custom script on personal sites and self-service created sites.
During migration, some web parts require this setting set to allow. Otherwise, the web part will not be migrated.
At least 24 hours before you start migration, do the following:
Go to the Settings page of the new SharePoint admin center, and sign in with an account that has admin permissions for your organization.
Note
If you have Office 365 Germany, sign in to the Microsoft 365 admin center, then browse to the SharePoint admin center and open the Settings page.
If you have Office 365 operated by 21Vianet (China), sign in to the Microsoft 365 admin center, then browse to the SharePoint admin center and open the Settings page.At the bottom of the page, select classic settings page.
Under Custom Script, select:
Allow users to run custom script on personal sites
Allow users to run customer script on self-service created sitesLeave these settings in place for the duration of your migration.
Note
Changes to this setting might take up to 24 hours to take effect.
For more info, see, Allow or prevent custom script.
Note about logging in
When you first launch the SharePoint Migration Tool (SPMT), you are prompted for your Microsoft 365 username and password. The credentials you provide will be to the migration destination.
Authentication supported
SPMT supports the following authentication methods:
- NTLM
- Kerberos
- Forms
- ADFS
- Multi-factor authentication
- SAML-based claims
- Client certificate authentication
Important
If the on-premises server is configured to support multiple authentication providers, including Windows authentication, then Windows authentication will not be supported. If this describes your environment, use other authentication methods instead of Windows authentication.
Where is your data currently located?
Before you start using the SharePoint Migration Tool (SPMT), note where your data is located, and where you want those files located after migration. You will be prompted for the current location of your data files and the location of the SharePoint site where you want them copied. SPMT lets you select from two sources from which to migrate your data: from an on-premises SharePoint Server 2010 or 2013 site, or from a local file share or network path.
SharePoint on-premises: Helvetica neue lt pro (linotype) font download free. If you select the SharePoint on-premises option, you are prompted to enter the name of the SharePoint Server site where your files are located and prompted for your credentials for that site. You will indicate what document library you wish to migrate.
Note
SPMT supports SharePoint Server 2010* and 2013.
File share: If you select the file share option, you are prompted to enter the location of the file share, the URL of the SharePoint site, and the document library where they will be copied. The files are not deleted from the source.
Using the SharePoint Migration tool
To install the current release download, go to: SharePoint Migration Tool
Migrating data files from SharePoint Server document libraries
Start SPMT, and then enter your Microsoft 365 username and password.
Select Start your first migration.
Select SharePoint Server.
Enter the SharePoint Server site URL where your content is located, and then select Next. Houdahspot 4 0 – advanced file search tool.
Important
Proxy connections are not supported. Using Proxy connections yields errors such as 'SharePoint login fail' or 'cannot load document library'.
Enter your username and password to the SharePoint Server site; username must use the format of someone@example.com. Select Sign in.
Note
If you have already signed in to that site once while using this tool, you won't be prompted again for the same site.
Select the document library where your files are located. The dropdown contains all your possible choices.
Enter the URL of the SharePoint site where you want your files migrated.
Select the document library to where your files will be copied.
Select Add. This task is added to the list. If you want to select another set of data files to migrate, select Add a source.
Migrating data files from a local file share
Start SPMT, and then enter your Microsoft 365 username and password.
Select Start your first migration.
Select File Share.
Enter the source path of the file share where your content is located, and then select Next.
Enter the URL of the SharePoint site where you want your files migrated, and then select Next.
Note
If you have already signed in to that site once while using this tool, you won't be prompted again for the same site.
Select the document library to where your files will be copied, and then select Next.
Appgraphics 1 1. This task is added to the list. If you want to select another set of data files to migrate, select Add another source.
When you have finished selecting your sources, select Next.
Review your settings, and then select Migrate.
To use a JSON or CSV file for bulk migration
If you have many sources to migrate, you can use either a JSON or CSV file to do a bulk migration. To learn more on how to create a JSON or CSV file for data content migration, see How to format your JSON or CSV file for data content migration.
Start SPMT, and then enter your Microsoft 365 username and password.
Select Start your first migration.
Select JSON or CSV file for bulk migration.
Enter the full path of your .CSV or .JSON file where your content is located, and then select Add.
Enter the URL of the SharePoint site where you want your files migrated, and then select Next.
Note
If you have already signed in to that site once while using this tool, you won't be prompted again for the same site.
Select JSON or CSV file for bulk migration. Enter the location of your file, or select Choose File to locate it. Select Add.
If you are migrating files from an on-premises SharePoint Server, you are prompted for your username and password for that site unless you provided those credentials in previous steps.
If any errors appear in your file, it is detected on a line-by-line basis. The error indicates which line or lines contain(s) the errors. You cannot proceed until you correct the errors in your file.
Important
We do not support proxy connections. Using Proxy connections yields errors, such as 'SharePoint login fail' or 'cannot load document library'.
If you want to select another set of data files to migrate, select Add a source; otherwise, select Next.
Review your settings, and the select Migrate.
Monitoring and reporting status of migration jobs
After you select Migrate, the progress of your migration jobs appears. As they complete, you can view either detailed or summary reports of an individual job or a single summary report that includes all migration jobs submitted during this session. To learn more, see Using the SharePoint Migration Tool Reports.
Resuming migration jobs
If you need to close SPMT before a submitted job has completed, you can restart the tool from any computer.
Note
To resume a submitted migration job, it has to have been running at least5 minutes. It pauses at the point you closed the SPMT. If your submitted job was running less than five minutes before the tool closed, you must resubmit the job.
To resume migration jobs
Launch SPMT. Using the same Microsoft 365 username and password you used when you originally submitted the job, select Sign In.
After you sign in, a screen displays any paused migrations, providing details about what has been completed and what remains.
If you want to add additional migration tasks, select Select new sources and destinations; otherwise, select Next. Your migration jobs will be resumed. If you are migrating files from an on-premises SharePoint Server, you are prompted for your username and password for that site.
Incremental migration
After a migration task has completed, you can save it to be rerun at a later date, allowing you to copy only those new or updated files in the source location.
Note
If you wish to make changes to this setting, do so before your initial migration job is submitted. This setting is global; it will apply to all subsequent tasks you submit.
When this setting is on, an incremental check of the SharePoint target environment is performed. Files are evaluated as follows:
Status | Result |
---|---|
Modified time of the source file is earlier than the modified time of the target file. | File will not be migrated. |
Files or lists exist in the SharePoint target location. | Migration will skip those existing objects during scan. |
Time stamp on files or object in the source location is newer in the source | The newer files are migrated. |
Source is a file share. | Validation for migration will be based on the file/folder path. |
Source is an on-premises SharePoint Server/ | Validation for migration will be based on list item GUID. Use the folder path as a fallback. |
File Multi Tool 6
Availability
Note
File Multi Tool 6 2010 Reviews
Currently, the SharePoint Migration Tool is not available for users of Office 365 operated by 21Vianet in China.
It is also not available for users of Microsoft 365 with the German cloud with the data trustee, German Telekom. However, we do support it for users in Germany whose data location is not in the German datacenter.