Tchater maintenant avec le support
Tchattez avec un ingénieur du support

On Demand Migration Current - User Guide

About On Demand Migration Working with On Demand Migration Account Migration Mailbox Migration OneDrive Migration Microsoft Teams Migration Microsoft 365 Groups Migration SharePoint Migration Public Folders Migration Troubleshooting Finalizing the Migration Appendix A: Using PowerShell

Mapping Sites

By default, the OnDemand Migration for SharePoint service will migrate a site using the same relative url and name as the source site. This step is particularly helpful when the source and target sites have different names or are located at different places. You can also change the template of sites with unsupported templates. There are two ways to map sites:

A site cannot be mapped if it was previously migrated in the same project. See the Considerations topic for details about migration behavior if the target site or sub-site that is mapped, already exists before the migration is started.

Mapping a specific site from the user interface

To change the name of a specific migrated site, relocate the site with a different Url or change an unsupported template during migration, follow the steps described below.

  1. Log in to Quest On Demand and choose an organization if you have set up multiple organizations.
  2. From the navigation pane, click Migration to open the My Projects list.
  3. Create a new project or open an existing project.
  4. Click theSharePointtile, or click Open from the SharePoint tile to open the SharePoint Migration Workspace.
  5. Go to the SharePoint Contents tab.
  6. Select a specific site and then click Map Site from the site detail pane.

  7. The New Site Mapping Task wizard opens. Specify the information in the steps described below:
  8. Step 1: Map Settings

    1. Specify the new target site name and url :
      • New Target Site Name - specify the new name of the target site (root website) if necessary, or retain the original name.
      • New Target Url - specify the relative url in the target tenant or retain the original value. You can specify a different relative url in the target tenant to relocate the site if necessary.
    2. Specify a supported target site template. This option is available if the selected site has an unsupported template.

      NOTE:

      To find sites with unsupported site templates, clear the filters in the search ribbon. Then set the following filters: Migration = Unsupported and Type = Sites

      Template mapping is only available for unsupported templates. When you use a supported template, the original site features may not be provisioned. However, supported lists and list items can now be migrated to the target tenant.

      Limitation: Sites with the "TeamsChanne#0" or "TeamsChanne#1" template cannot be mapped to a different template. These TeamsChannel based sites are provisioned with the ODM Teams provisioning task.

      • New Target Site Template - choose a supported template. The options are: Communication and Teams site (no Microsoft 365 group).

    3. Promote child webs to sites - select this option to promote all first level child webs in this site to a new site. Promoted site name and url will be based on the current name of the promoted child web. This option is available for supported sites only. Sites with unsupported templates cannot be promoted.
    4. Click Next.
  9. Step 2: Summary
    1. Verify the task specifications as described below:
      • Name - name of the task. The default name is Map Single SharePoint Object Task. You can specify a custom name.
      • New Target Site Name - new name of the target site (root website)
      • New Target Url - the relative url in the target tenant.
      • New Target Site Template - option to match sub-sites and other descendant structures.
    2. Click Back to revise or review a previous step or click Finish to complete the task wizard and start the task as scheduled.
  10. You can track the progress in the Tasks tab, monitor alerts and notifications in the Events tab and view the summary on the Dashboard.
  11. When the task completes, the SharePoint Contents list is updated. Compare the Source Urlcolumn with the Target Url column for the selected site. The Provision state of the selected site is set to Mapped.

Mapping one or more sites with a CSV file

To change the name of a migrated site or relocate the site with a different Url, use a CSV file to set up a custom map. URLs in a mapping file are case sensitive and must be relative URLs. This is a two-step process:

NOTE: If your sites are geo-enabled, we recommend that you run the Map Geo Location task before you run the Mapping from File task. The Mapping from File task sets the geo locations using the default settings, and once the target location is set it can't be reset by the Map Geo Location task.

Workaround: Delete site from the SharePoint Contents list and rerun the Discover Site Collections task.

Step 1: Prepare the CSV file

There are three ways to prepare a CSV site mapping file.

NOTE: Sites cannot be merged or reorganized with a mapping file. Site templates cannot be changed with a CSV file.

  1. Download the CSV file from the SharePoint Admin Center
    1. Log in to the SharePoint Admin Center of the source tenant.
    2. From the navigation pane, click Active sites.
    3. From the Active sites page menu, click Export to download the CSV file.
    4. In the CSV file, delete all columns before the URL column. Rename the URL column header to either SourceURL. This must be the first column.
    5. In the SourceURL column keep only the sites that you want to map. Ensure that only relative URLs are used.
    6. Insert a blank column as the second column and specify the header as either TargetURL This must be the second column.
    7. Specify the corresponding target URLs. Ensure that only relative URLs are used.
  2. Download the CSV file from the SharePoint Contents page
    1. Choose one or more sites by selecting the respective check box for the site. You can select the check box in the column header to select all sites.
    2. Click Export from the Actions ribbon.
    3. Extract the CSV file from the downloaded ZIP file.
    4. In the CSV file, delete all columns before the SourceURL column. This must be the first column.
    5. Insert a blank column as the second column and specify the header as either TargetURL. This must be the second column.
    6. Specify the corresponding target URLs. Ensure that only relative URLs are used.
  3. Create a new CSV file and specify the column header in the first row and then enter the URLs in the subsequent rows manually. Since URLs in a mapping file are case sensitive, this method must be used with caution.

    NOTE:

    • You need to map only the URLs that will change in the target Tenant.
    • You can download a CSV template when you start the New Mapping from File Task wizard and click Download Example File from the Mapping File step.
    • CSV file names with non-ASCII characters are not supported.
    1. In the first column, specify the header as either SourceURL.
    2. In the second column, specify the header as either TargetURL.
    3. Enter the source and target URLs manually in the subsequent rows . Ensure that only relative URLs are used.
    4. Save the CSV file. You may rename the file if needed.

Example 1 - The Target URL is used to rename a site from the source tenant.

  • The URL /sites/StarzBrand has been renamed to /sites/StarzCorporate.
  • The URL /sites/StarzAccounting has been renamed to /sites/StarzFinance.
  • The URL /sites/Starzmarketing has been renamed to /sites/StarzMarketing.
  • The URL /sites/Starzteam has been renamed to /sites/StarzTeam.

Example 2 - The target URL is used to relocate the root site.

The root URL is relocated to a managed site in the target tenant called /sites/oldroot.

Step 2: Start the Mapping from File Task

  1. Log in to Quest On Demand and choose an organization if you have set up multiple organizations.
  2. From the navigation pane, click Migration to open the My Projects list.
  3. Create a new project or open an existing project.
  4. Click theSharePointtile, or click Open from the SharePoint tile to open the SharePoint Migration Workspace.
  5. Go to the SharePoint Contents tab.
  6. Click More Actions from the Actions ribbon and then click Map from File. The New Mapping from File Task wizard opens.

  7. Step 1: Mapping File
    1. Click Browse and locate the CSV mapping file.
    2. Click Open in the File Explorer window to load the file into the wizard
    3. Click Next.
  8. Step 2: Schedule
    1. 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 will be started at a future date and time entered in the corresponding calendar field.
    2. Click Next.
  9. Step 3: Summary
    1. Verify the task specifications as described below:
      1. Name - name of the task. The default name is Mapping from File Task. You can specify a custom name.
      2. Source tenant - name of the tenant where the source URLs exist.
      3. Target tenant - name of the tenant where the target URLs may or may not exist.
      4. Scheduled start - date and time when the task will start. Now indicates that the task will start immediately.
    2. Click Back to revise or review a previous step or click Finish to complete the task wizard and start the task as scheduled.
  10. You can track the progress in the Tasks tab, monitor alerts and notifications in the Events tab and view the summary on the Dashboard.
  11. When the task completes, 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 Mapped.

 

Matching Sites

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:

  1. Log in to Quest On Demand and choose an organization if you have set up multiple organizations.
  2. From the navigation pane, click Migration to open the My Projects list.
  3. Create a new project or open an existing project.
  4. Click the SharePoint tile, or click Open from the SharePoint tile to open the SharePoint Migration Workspace.
  5. Click the SharePoint Contents tab from to open the SharePoint Contents list view.
  6. 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.
  7. Click More > Match from the Actions ribbon. The New Matching Task wizard opens.
  8. Step 1: Matching Option
    • SharePoint objects selected - indicates the 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.
  9. Step 2: Schedule
    1. 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 will be started at a future date and time entered in the corresponding calendar field.
    2. Click Next.
  10. Step 3: Summary
    1. Verify the task specifications as described below:
      1. Name - name of the task. The default name is Matching Task. You can specify a custom name.
      2. Source tenant - name of the tenant where the source URLs exist.
      3. Target tenant - name of the tenant where the source URLs may or may not exist.
      4. Scheduled start - date and time when the task will start. Now indicates that the task will start immediately.
      5. Include site structure - option to match webs and other descendant objects.
    2. Click Back to revise or review a previous step or click Finish to complete the task wizard and start the task as scheduled.
  11. You can track the progress in the Tasks tab, monitor alerts and notifications in the Events tab and view the summary on the Dashboard.
  12. When the task completes, 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.

Collecting Statistics

A Collect SharePoint Statistics Task conducts an assessment of all SharePoint sites in the source tenant and matching sites in the target tenant.

Each Collect SharePoint Statistics Task generates events. Events are milestones that a task achieves as it runs. For example, when an Collect SharePoint Statistics Task starts, an event is logged and it appears in the events list. When the number of sites that are selected for assessment is large, the Collect SharePoint Statistics Task divides the total number of sites into manageable sets. Each set is called a batch. When a batch of sites is assessed, another event occurs.

NOTE: Before you proceed, verify that the source tenant sites have been discovered. For more information see Discovering Sites

In this topic:

Create a Collect SharePoint Statistics Task

  1. Log in to Quest On Demand and choose an organization if you have multiple organizations.
  2. From the navigation pane, click Migration to open the My Projects list.
  3. Create a new project or open an existing project.
  4. Click the SharePoint tile, or click Open from the Mail tile to open the sites and User Data dashboard.
  5. Select the Sites tab and then select List View if not already selected. Then select one or more SharePoint sites from the list to activate the menu options.
  6. From the Actions menu, click Collect Statistics. The New Collect SharePoint Statistics Task wizard opens.
  7. Step 1: Description

    1. 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.
    2. 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.
    3. Click Next.
  8. Step 2: Notification
    1. 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.
    2. Recipients - enter the email address of the recipients of this email. You can specify multiple recipient email addresses separated by semicolon.
    3. Click Next.
  9. Step 3: Schedule
    1. 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 will be started at a future date and time entered in the corresponding calendar field.
    2. Click Next.
  10. Step 4: Summary
    1. Verify the task specifications as described below:
      1. Name - name of the task. You can specify a custom name. The default name is Collect SharePoint Content Statistics Task
      2. Source tenant - name of the tenant where the statistics will be collected.
      3. Scheduled start - date and time when the task will start. Now indicates that the task will start immediately.
    2. 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

  1. Open the Tasks tab.
  2. Select the Collect SharePoint Statistics Task that you want to review.
  3. In the task details pane that opens, the information presented is as described below:
    1. Type - type of the task. The type is SharePoint.
    2. Created - date and time when the task was created.
    3. Modified - date and time when the task was last updated.
    4. State - state of the task.
    5. Last Operation - action that was most recently performed in this task.
    6. Schedule - date and time when the task started. Now indicates that the task started immediately after the task was created.
    7. Contents (number) - number of objects processed and their task status.
    8. Events (number) - number of events that the task encountered.

Review the statistics collected

  1. Open the Tasks tab.
  2. Select the Collect SharePoint Statistics Task that you want to review.
  3. From the task details pane, click Download Premigration Report. If comparison reports were generated, click Download comparison report.
  4. Download and save the ZIP file to a suitable folder, and extract the report.

Review the Collect SharePoint Statistics Task Events

  1. Open the Tasks tab.
  2. Select a task named Collect SharePoint Statistics Task that you want to review.
  3. In the task details pane that opens, click Events (number). The Events tab opens with a filtered list of events for the selected task.
  4. Select an event that you want to review. In the task details pane that opens, the information presented is as described below:
    1. Object - name of the SharePoint object if applicable.
    2. Task - name of the task.
    3. Time - date and time when the event occurred.
    4. Category - type of task. the value is Application.

Managing Sites with Collections

SharePoint site collections, sites and lists can be grouped in collections.

Migrating large numbers of SharePoint site collections requires careful planing. 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.

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
    1. Log in to Quest On Demand and choose an organization if you have multiple organizations.
    2. From the navigation pane, click Migration to open the My Projects list.
    3. Create a new project or open an existing project.
    4. From the project dashboard, click Open in the SharePoint tile to open the SharePoint workspace.
    5. From the top-right corner of the workspace, click Select Collection and then select the collection to view. The collection Dashboard is displayed.
    6. Click the SharePoint Contents tab. You will see the list of SharePoint site collections that belong to the collection.
  • To see the tasks for collection-specific sites, use the corresponding tile on the collection Dashboard or open the Tasks tab.
  • To see the events related to the collection, use the corresponding widget on the collection Dashboard or open the Events tab.
  • To rename or delete the collection, click the corresponding buttons in the toolbar.
  • To return to the project dashboard, click the project name in the navigation bar.

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:

  1. From the project dashboard, click Open in the SharePoint tile to open the SharePoint workspace.
  2. Select the SharePoint Contents tab.
  3. Select the SharePoint site collections you want to combine into a collection.
  4. From the actions toolbar, click New Collection. The New Collection dialog opens.
  5. 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:

  1. From the project dashboard, click Open in the SharePoint tile to open the SharePoint workspace.
  2. If you need to create a new collection:
    1. From the top-right corner of the workspace, click Select Collection > + New Collection
    2. Enter a collection name and click Save to add this collection to the project.
  3. From the actions toolbar, click the SharePoint Contents tab and select the site collections that you want to add to the collection.
  4. Click More Actions > Add to Collection. The Add to existing collection dialog opens.

  5. Select a collection from the Collection name dropdown and click Save to add the selected SharePoint sites to the collection.

To create one or more collections with a CSV file:

This is a two-step process as described below:

Step 1: Prepare the CSV file

NOTE: CSV file names with non-ASCII characters are not supported. 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 site collections.
  • SharePoint site collections can be listed in multiple collections.
  • You can download a CSV template when you start the Import Collections from File wizard and click Download Example File from the Discovery Options step.
  • CSV file names with non-ASCII characters are not supported.

Use the format shown below:

SourceURL - site collection URL.

Collection - collection name.

Step 2: Import the CSV file

  1. Click the SharePoint Contents tab.
  2. From the actions toolbar, click More Actions and then click Import Collections. The Import Collections from File wizard starts.

  3. Click Browse and select the CSV file. The selected CSV file name appears.
  4. Click Open in the File Explorer window to load the file into the wizard.
  5. Click Import.

NOTE: SharePoint site collection URLs in the CSV that have not been discovered cannot be added to the collection.

To gather a site and all its children into a collection

  1. From the top-right corner of the workspace, click Select Collection and then select the collection to view.
  2. If needed, add one or more SharePoint site collections to the collection
  3. Select one or more site collections.
  4. 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 .

Documents connexes

The document was helpful.

Sélectionner une évaluation

I easily found the information I needed.

Sélectionner une évaluation