Get this summer started off on the right foot and accelerate your migration to Office 365.  More than 200,000 organizations and 190 million people have SharePoint for intranets, team sites and content management, join the ranks of those transforming their workplace with the SharePoint Migration Tool from Microsoft.


Helping people share files and collaborate on content has always been central to SharePoint.  At the core of these principles is the content itself, the documents you create, the documents you manage, the documents you share and now we’re making it easier than ever to take advantage of the power content management and collaboration capabilities in SharePoint and OneDrive so you can share and manage content, knowledge, and applications to empower teamwork, quickly find information, and seamlessly collaborate across your organization.


Based on your feedback, today we’re pleased to share that we’re adding new support for Windows PowerShell to the SharePoint Migration Tool.  With these new capabilities you’ll be able to address scale migrations and deliver automated, programmatic migration solutions through the SharePoint Migration Tool.


If you’re not familiar with the SharePoint Migration Tool we invite you to learn more about it here https://aka.ms/spmt.


New capabilities in this release include:


Ability to script migration jobs with new Windows PowerShell CmdLets:


  1. Register-SPMTMigration : Creates a SPMT migration session
  2. Add-SPMTTask : Adds a new migration task to the registered migration session
  3. Remove-SPMTTask : Removes an existing migration task from the registered migration
  4. Start-SPMTMigration  : Starts the current migration session
  5. Get-SPMTMigration : Returns the object of current session. It includes information regarding to current tasks and current settings
  6. Show-SPMTMigration : Displays the task ID, data source location, target location and migration status in the console
  7. Stop-SPMTMigration  : Stops/cancels the current migration session
  8. Unregister-SPMTMigration : Removes the  SPMT migration session created.

Sample Migration Script (Expand to View)

#Define On-prem SharePoint 2013 data source#


$Global:SourceSiteUrl = "http://YourOnPremSite/"
$Global:OnPremUserName = "Yourcomputer\administrator"
$Global:OnPremPassword = ConvertTo-SecureString -String "OnPremPassword" -AsPlainText -Force $Global:SPCredential = New-Object -TypeName System.Management.Automation.PSCredential -ArgumentList $Global:OnPremUserName, $Global:OnPremPassword
$Global:SourceListName = "SourceListName"


#Define SPO target#


$Global:SPOUrl = “https://contoso.sharepoint.com
$Global:UserName = “admin@contoso.onmicrosoft.com
$Global:PassWord = ConvertTo-SecureString -String "YourSPOPassword" -AsPlainText -Force
$Global:SPOCredential = New-Object -TypeName System.Management.Automation.PSCredential -ArgumentList $Global:UserName, $Global:PassWord
$Global:TargetListName = "TargetListName"


#Define  Fileshare data source#


$Global:FileshareSource = "YourFileShareDataSource"


#Import SPMT Migration Module#


Import-Module Microsoft.SharePoint.MigrationTool.PowerShell


#Register the SPMT session with SPO credentials#


Register-SPMTMigration -SPOCredential $Global:SPOCredential -Force


#Add two tasks into the session. One on-prem and one file share task.#


Add-SPMTTask -SharePointSourceCredential $Global:SPCredential -SharePointSourceSiteUrl $Global:SourceSiteUrl  -TargetSiteUrl $Global:SPOUrl -MigrateAll Add-SPMTTask -FileShareSource $Global:FileshareSource -TargetSiteUrl $Global:SPOUrl -TargetList "Documents"


#Start Migration#



For additional details on these new CmdLets and more refer to https://go.microsoft.com/fwlink/?linkid=2003100.


If you’re just starting your migration journey, it’s a good practice to know what, if any, issues you may face before committing to the migration and how to remediate those issues before you get started. 

In addition to the SharePoint Migration Tool,, to help you bring you content to the cloud, we’ve also engineered the SharePoint Migration Assessment Tool to help you diagnose and resolve pre-migration issues.  To learn more about the SharePoint Migration Assessment Tool visit https://aka.ms/smat.


“We’ve been migrating our entire customer community to Azure and Office 365, where we’ve seen our threat risk diminish extraordinary, especially around email. That’s given us tremendous confidence.” - Brett Bailey, Vice-President, WBM Technologies


Kick start your migration to Office 365 to take advantage of the latest in communications, collaboration, and security and join a growing number of customers moving to Office 365.

To learn more about migration to Office 365 visit https://docs.microsoft.com/en-us/sharepointmigration/migrate-to-sharepoint-online.


We’d love to hear your feedback on the SharePoint Migration Tool, let us know in the comments below and through UserVoice at https://sharepoint.uservoice.com/forums/282887-sharepoint-hybrid-or-migration-to-office365.

Occasional Visitor

Can not wait for Microsoft to release these cmdlets so we can start using the new PowerShell commands!! :D

Frequent Visitor

When do you plan to make the PowerShell module to be available? I am looking forward to testing it on our environment.


@Yevhen Zavaliy The SharePoint Migration Tool is updated automatically when opened when new updates are available.  You should see an update to the SharePoint Migration Tool on next run beginning today thru Wednesday.

  1. Click http://aka.ms/spmt will bring you to the TechNet article Introducing the SharePoint Migration Tool
  2. Click SharePoint Migration Tool Version 2, Click install first release, the PowerShell module  will be copied to %userprofile%\Documents\WindowsPowerShell\Modules.
  3. After installation successfully, run Import-Module, you can use the cmdlets to migrate your data.
  • Import-Module Microsoft.SharePoint.MigrationTool.PowerShell
Frequent Visitor

Thank you for your help! I was able to install the first release of SPMT and import PowerShell Module successfully!


Will this be available for use in an Azure function to help with tenant to tenant migrations?


@Sean Douglas 

Tenant to Tenant move is not supported by SPMT,  Please vote in user voice, thanks.


Click https://github.com/MicrosoftDocs/office-docs-powershell/tree/master/spmt/spmt-ps/spmt, you will find all PowerShell cmdlets documents in GitHub.