To check if the site already exists on the target or it is correctly mapped, match the source sites with the corresponding target sites using a Matching Task. If a match is found the site state is set to Matched and the target Url is updated. Discovered content for the selected sites can also be matched using the Include child site structure setting in the New Matching Task wizard.
This step is optional. The SharePoint migration service will match and migrate the source site to the existing target site (the target site and content will be replaced), or create the site as needed base on the default or site mapping.
To match sites:
- Sign in to Quest On Demand and choose an organization if you have set up multiple organizations.
- From the navigation pane, click Migrate > Projects to open the My Projects list.
- Create a new project or open an existing project.
- Click the SharePoint tile, or click Open from the SharePoint tile to open the SharePoint Migration Workspace.
- Click the SharePoint Contents tab to open the SharePoint Contents list view.
- Choose one or more sites by selecting the respective check box for the sites. You can select the check box in the column header to select all sites.
- Click More > Match from the Actions ribbon. The New Matching Task wizard starts. Each step is described below:
- Matching Option
- SharePoint objects selected - number of sites selected for matching.
- Include child site structure - select this option to include matching discovered site content (webs and other descendant objects) with the matching task. This will increase the task run time significantly.
- Schedule
- Choose from one of three options to schedule the task. The scheduler will be activated after you complete the task wizard.
- Run now - task runs immediately.
- Run later - task must be started manually.
- Schedule - task starts at a future date and time entered in the corresponding calendar field.
- Click Next.
- Summary
- Verify the task specifications as described below:
- Name - name of the task. You can specify a custom name. The default name is Match SharePoint Sites.
- Source tenant - name of the tenant where the source URLs exist.
- Target tenant - name of the tenant where the source URLs may or may not exist.
- Scheduled start - date and time when the task will start. Now indicates that the task will start immediately.
- Include site structure - option to match webs and other descendant objects.
- Click Back to revise or review a previous step or click Finish to complete the task wizard and start the task as scheduled.
- You can track the progress in the Tasks tab, monitor alerts and notifications in the Events tab and view the summary on the Dashboard.
- After the task is complete, the SharePoint Contents list is updated. Compare the Source Urlcolumn with the Target Url column for the selected sites. The Provision state of each matched site is set to Matched.
A Collect SharePoint Statistics Task conducts an assessment of selected SharePoint sites, webs and lists in the source tenant and matching sites in the target tenant.
In this topic:
Create a Collect SharePoint Statistics Task
- Sign in to Quest On Demand and choose an organization if you have multiple organizations.
- From the navigation pane, click Migrate > Projects to open the My Projects list.
- Create a new project or open an existing project.
- From the project dashboard, click Open in the SharePoint tile to open the SharePoint migration workspace.
- Open the SharePoint Contents tab and select one or more SharePoint objects from the list to activate the menu options.
- From the Actions menu, click Collect Statistics. The New Collect SharePoint Statistics Task wizard starts. Each step is described below:
- Description
- Include collection of statistics for source content and structure - select this option to discover and collect statistics of the SharePoint contents and structure for the selected source objects.
- Include collection of statistics from the matching target SharePoint objects - select this option to collect statistics from the matching SharePoint objects in the target tenant and generate the Comparison Report.
|

|
NOTE: If the SharePoint objects have not been migrated by On Demand Migration but already exist on the target, the source and target objects will be matched using the same process as a Matching task. Subsequent migrations will respect the established match relationship. |
- Click Next.
- Notification
- Send notification email once the task is completed - select this option to send a notification email when a discovery task completes.
- Only in a case of failure - select this option to send the email if the discovery task fails to complete successfully.
- Recipients - enter the email address of the recipients of this email. This field is available after you select the notification option and is pre-filled with your email address. Specify multiple recipient email addresses separated by semicolons.
- Click Next.
- Schedule
- Choose from one of three options to schedule the task. The scheduler will be activated only after you complete the task wizard.
- Run now - task runs immediately.
- Run later - task must be started manually.
- Schedule - task starts at a future date and time entered in the corresponding calendar field.
- Click Next.
- Summary
- Verify the task specifications as described below:
- Task Name - name of the task. You can specify a custom name. The default name is Collect SharePoint Statistics.
- Source tenant - name of the tenant where the statistics will be collected.
- Scheduled start - date and time when the task will start. Now indicates that the task will start immediately.
- Click Back to revise or review a previous step or click Finish to complete the task wizard and start the task as scheduled.
Review the Collect SharePoint Statistics Task
- Open the Tasks tab.
- Select the Collect SharePoint Statistics task.
- In the task detail pane that opens, the information presented is as described below:
- Type - type of the task. The type is SharePoint.
- Created - date and time when the task was created.
- Modified - date and time when the task was last updated.
- State - state of the task.
- Last Operation - action that was most recently performed in this task.
- Schedule - date and time when the task started. Now indicates that the task started immediately after the task was created.
- Contents (number) - number of objects processed and their task status.
- Events (number) - number of events that the task encountered.
Review the statistics collected
- Open the Tasks tab.
- Select the Collect SharePoint Statistics task.
- From the task detail pane, click Download Premigration Report. If comparison reports were generated, click Download comparison report.
- Download and save the ZIP file to a suitable folder, and extract the report.
Review the Collect SharePoint Statistics Task Events
- Open the Tasks tab.
- Select a task named Collect SharePoint Statistics Task that you want to review.
- In the task detail pane that opens, click Events (number). The Events tab opens with a filtered list of events for the selected task.
- Select an event that you want to review. In the task detail pane that opens, the information presented is as described below:
- Object - name of the SharePoint object if applicable.
- Task - name of the task.
- Time - date and time when the event occurred.
- Category - type of task. the value is Application.
SharePoint site collections, sites and lists can be grouped in collections.
Migrating large numbers of SharePoint site collections requires careful planning. The site collections could belong to different offices and geographical locations or sensitive departments. Organize the SharePoint site collections into logical groups called collections to make large SharePoint site collections more manageable. SharePoint sites, webs and lists can be grouped in collections.
In this topic:
Adding SharePoint site collections to Collections
You can add SharePoint site collections to collections in three ways:
To add selected SharePoint site collections to a new collection:
- From the project dashboard, click Open in the SharePoint tile to open the SharePoint workspace.
- Select the SharePoint Contents tab.
- Select the SharePoint site collections you want to combine into a collection.
- From the actions toolbar, click Collections > Create New Collection. The New Collection dialog opens.
- Enter a collection name in the Collection name field and click Save to add the selected SharePoint site collections to the collection.
To add selected SharePoint site collections to an existing collection:
- From the project dashboard, click Open in the SharePoint tile to open the SharePoint workspace.
- If you need to create a new collection:
- From the top-right corner of the workspace, click Select Collection > + New Collection
- Enter a collection name and click Save to add this collection to the project.
- From the actions toolbar, click the SharePoint Contents tab and select the site collections that you want to add to the collection.
- Click Collections > Add to Collection. The Add to existing collection dialog opens.

- Select a collection from the Collection name dropdown and click Save to add the selected SharePoint sites to the collection.
To add sites to one or more collections with a CSV file:
Using a CSV file provides the following additional benefits:
- Multiple collections can be created with the same CSV file.
- Existing collections can be specified in the CSV file to add additional sites.
- SharePoint sites can be listed in multiple collections.
This is a two-step process as described below:
Step 1: Prepare the CSV file
- From the actions toolbar, click Collections > Import Collections. The New Import Collections from File Task wizard starts.
- From the Mapping File step, click Download Example File. A ZIP file is downloaded.
- Extract the CSV file and use it to prepare your import file in one of three formats described below:
|

|
NOTE: CSV file names with non-ASCII characters are not supported. SharePoint sites in the CSV that have not been discovered cannot be added to a collection. |

- SourceURL - site collection URL.
- Collection - collection name.
Step 2: Import the CSV file
- Open the SharePoint Contents tab.
- From the actions toolbar, click Collections > Import Collections. The New Import Collections from File Task wizard starts.
- Mapping File
- Click Browse and select the CSV file. The selected CSV file name appears.
- Schedule
- Choose from one of three options to schedule the task. The scheduler will be activated after you complete the task wizard.
- Run now - task runs immediately.
- Run later - task must be started manually.
- Schedule - task starts at a future date and time entered in the corresponding calendar field.
- Click Next.
- Summary
- Verify the task specifications as described below:
- Name - name of the task. You can specify a custom name. The default name is Import Collections From File.
- Scheduled start - date and time when the task will start. Now indicates that the task will start immediately.
- Click Back to revise or review a previous step or click Finish to complete the task wizard and start the task as scheduled.
- Click Finish.
To gather a site and all its children into a collection
- From the top-right corner of the workspace, click Select Collection and then select the collection to view.
- If needed, add one or more SharePoint sites to the collection
- Select one or more sites.
- Run the Discover SharePoint Contents task.
|
|
NOTE: SharePoint content discovered during a migration will be added to the collection as well if the parent site collection is present . |
To verify the addition of the SharePoint objects to a collection:
- Check the Collections column in the SharePoint Contents List View that indicates the most recent collection where the object has been added and the number of additional collections that also contain the object.
- Select an object from the List View to open the SharePoint Detail pane. Check the Collections property that lists all the collections where the object has been added.
Working with the Collection Dashboard
The Collection Dashboard shows the collection-specific summary, allows you to see SharePoint site collections added to it, create tasks for them, and monitor the progress of tasks.
To view the collection dashboard for an existing collection:
- Sign in to Quest On Demand and choose an organization if you have multiple organizations.
- From the navigation pane, click Migrate > Projects to open the My Projects list.
- Create a new project or open an existing project.
- From the project dashboard, click Open in the SharePoint tile to open the SharePoint workspace.
- From the top-right corner of the workspace, click Select Collection and then select the collection to view. The collection Dashboard is displayed.
- Click the SharePoint Contents tab. You will see the list of SharePoint site collections that belong to the collection.
To remove items from a collection:
- From the actions toolbar, click Collections > Remove from Collection.
- In the confirmation dialog click Remove to remove the selected objects from the collection.
To rename the collection:
- Click Collections > Rename Collection in the Actions toolbar of the collections dashboard.
To delete the collection:
- Click Collections > Delete Collection in the Actions toolbar of the collections dashboard.
To see the tasks for collection-specific SharePoint objects:
- Open the Tasks tab.
To see the events related to the collection:
- Open the Events tab.
To return to the SharePoint migration workspace:
- Click the collection dropdown at the top-right corner of the page, and select Show All.
Webs or sub-sites that have not been migrated can be renamed, mapped to a different parent, or promoted to a site in the target tenant. When these objects are migrated, they will be renamed, relocated to the new parent or promoted to a site. The web is retained in the source tenant but set as Relocated (ie., not migratable)
The conditions for mapping a web to another web are as follows:
- Web has not been previously migrated.
- Web is not a root web. A root web can't be mapped to another root web in the target tenant. See Mapping Sites to do this.
When a root web is mapped to a child web of another site in the target tenant, it is deemed a demotion.
When a child web is mapped to a root web in the target tenant, it is deemed a promotion. If a web is promoted to a site, then:
- Site must have a new name.
- A new site and member objects are cloned from the web's parent site.
- Web is cloned as the root web of the new site.
- Children of the web are re-parented under the cloned web.
- Migrate the new site to complete the migration of the promoted web
Example: Consider the promotion of a web (\sites\HR\Benefits) to a site (\sites\HR-Benefits). After the task is complete, the SharePoint Contents list will display the following:
| Web |
HR-Benefits |
\sites\HR\Benefits |
\sites\HR-Benefits |
Limitations
- Links from the source web may not be updated on target. For example, links to the old parent.
- If a web has unique Members, Owners, and Visitors SharePoint groups, the memberships of these groups are merged with the corresponding groups from the source root web when the web is promoted. Review the target SharePoint group memberships after the migration completes.
Starting the Web Mapping Task
- Sign in to Quest On Demand and choose an organization if you have set up multiple organizations.
- From the navigation pane, click Migrate > Projects to open the My Projects list.
- Create a new project or open an existing project.
- From the SharePoint tile on the project dashboard click Open. Then select the SharePoint contents tab.
- Use the list filter Type = Web to narrow down your search.
- Select a web that has not been migrated. You can select only one web at a time. Then click Map Web from the list detail pane. The New Web Mapping Task wizard starts.

- Map Settings
- Task Name - name of the task. You can specify a custom name. The default name is Map SharePoint Web.
- Promote this web to a site collection - select this option to promote the web to a site. Webs with unsupported templates cannot be remapped and promoted to a site, so this setting is displayed if the selected web has a supported template.
- New Target Web Name - specify the new display name of the target web if necessary, or retain the original name.
- New Target Url - enter the new relative url of the web if you plan to relocate or demote the web. This option is not available if the web is intended for a promotion to a site.
- New Target Web Template - this option is available if the selected web has a Communications template or an unsupported template. Choose Teams site (no Microsoft 365 group) from the dropdown.
|

|
NOTE:
For webs with a Communications template, New Target Url must indicate a demotion like /sites/TargetParent/Demo when Source Url is /sites/Demo.
To find webs with unsupported web templates, clear the filters in the search ribbon. Then set the following filters: Migration = Unsupported and Type = Web
When you use a supported template, the original web features may not be provisioned. However, supported lists and list items can now be migrated to the target tenant. |
 |
 |
| Web with a Communications template being demoted and mapped. |
Web with an unsupported template being mapped. |
- Skip Child Webs - select this option to exclude child webs when migrating this web.
- Click Next.
- Summary
- Verify the task specifications as described below:
- Task Name - name of the task.
- New Target Web Name - new name of the target web
- New Target Url - relative url of the site or web in the target tenant.
- Promote this web to a site collection - indicates whether this web is being promoted.
- Click Back to revise or review a previous step or click Finish to complete the task wizard and start the task as scheduled.
- You can track the progress in the Tasks tab, monitor alerts and notifications in the Events tab and view the summary on the Dashboard.
- After the task is complete, the SharePoint Contents list is updated. Compare the Source Urlcolumn with the Target Url column for the selected web. The Provision state of the selected web is set to Mapped.