SharePoint Migration Assessment Tool (SMAT): A Quick Look

  • Simple cmd line tool that scans the content of on-premises farm to identify issues with migration to online
  • Slow running as it should be run against production and not cause usage degradation
  • Outputs log file for review and analysis
  • 2 modes, Assessment and Identity Mapping
  • Officially only supports SharePoint 2010 and 2013, but it worked fine for me on 2016

Running Assessment

  • Run As: farm or SP admin account, needs full access to farm
  • Config
    • SiteSkipList.csv – use to exclude sites
    • ScanDef.json – user to exclude scan functionality
  • Execution
    • Cmd console as administration
    • Smat.exe /help – for list of options
    • –t – Maximum number of thread (default 3, ramp it up to 6 max)
SharePoint Migration Assessment Tool - Running
SMAT: Running via cmd line


  • Summary and detailed csv report outputs are generated to review and analysis
  • A lot of “issues” are really non-issues, but may cause longer migration times, such as files with lots of versions and larger in size
  • Basically produces a bunch of stats and details to future investigate, or to base migration estimate times off
SharePoint Migration Assessment Tool - Output
SMAT: Output text files

Identity Mapping

  • Required Office 365 Global Admin permission to run to access resources
  • Smat.exe –configureidentitymapping – run by Tenant Admin to grant required permissions first if required
  • Smat.exe -generateidentitymapping
  • Essentially tries to map all user and group profiles in the SharePoint Server User Profile service application to what in the target tenant Azure Active Directory


Leave a Reply

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