SharePoint Migration tool

Recently Microsoft has released a new SharePoint Migration Tool. It’s a very good news because usually when you plan to move SharePoint On-premise to SharePoint Online you have multiple options :

  • you pay with sharegate or other solutions
  • you play with powershell and Azure to create package and move your data (and you have some limitations in term of size and what can be move or not)

At least Microsoft release a SharePoint Migration tool. You can get it here :
You can use IE or Chrome to download it but if you plan to use Chrome go to this site and then click Add to ChromeClickOnce for Google Chrome plug-in

With the SharePoint Migration Tool you can move your files from SharePoint on-premises document libraries (or file shares) to SharePoint or OneDrive in Office 365. It is free and available right now. Honestly you can use it for small and large migrations. Now let’s check this tool :

UI Sharepoint Migration Tool

Requirements to run SharePoint Migration tool :

To run this tool you need to get Windows Sever 2008 R2 or Windows 7 updated or better (of course if you have a server 2016 or a winsows 10 it will be better). Be sure that you have 150G of free storage and 8G of memory on the system running the tool.

Permissions between On-premise and Online :

To maintain existing SharePoint on-premises file permissions, there must be a corresponding user in SPO. The easiest way to accomplish this is to synchronize your Active Directory accounts to Azure Active Directory (AAD). If a corresponding user can not be found in SPO, files will be assigned the default permission of the location to which it has been migrated in SPO.

How to use SharePoint Migration Tool :

This tool can migrate from SharePoint 2013 On-premise, File share or even CSV File for Batch. I will cover only the features I’ve used for my own migrations : On-premise and CSV for batch.

Migrating data files from SharePoint Server document libraries :
  1. Start the SharePoint Migration tool. Click Next. Enter your Office 365 credentials and then click Sign in (you must admin permissions on the SharePoint Online)
  2. Choose a source and destination
  3. Select SharePoint Server (on-premises).
  4. Enter the SharePoint Server 2013 site URL where your data is currently located. Click Next.
  5. Enter your username and password to the SharePoint Server site (use the format: Then Click Sign in.
  6. In the dropdown list choose the document library where your files are located.
  7. Enter the URL of the SharePoint Online site where you want your files migrated.
  8. Select the document library to where your files will be moved.
  9. Click Add. This task will be added to the list. If you want to select another set of data files to migrate, click Choose a source and destination.
Multiple migration using a CSV file :
  1. Open the SharePoint Migration Tool if it is not already done and then click Next.
  2. Enter your Office 365 credentiasl and click Sign in.
  3. Select Choose a source and destination.
  4. Select Use a CSV file for bulk migration. Enter the location of your CSV file or click Choose File to locate. Click Add.
  5.  If you are migrating files from an on-premises SharePoint Server, you will have to enter your credentials 
  6. If you want to select another set of data files to migrate, click Choose a source and destination.
  7. When you have completed selecting your sources, click Migrate.

In Advanced Setting you can use some very interesting option to do an incremental migration or to do a pre-assessment to migration (turn Only perform scanning on).

if you want to know how this tool is working under the hood, check here :


Leave a Reply

Your email address will not be published. Required fields are marked *