Chat now with support
Chat with Support

Content Matrix 9.10 - SharePoint Edition

Introduction Activating the License Key Selecting the SQL Database You Want to Connect to Content Matrix Console End User Interface Enabling Advanced Mode Multilingual Support Connecting to SharePoint Preparing for a Migration How Content Matrix Handles Various SharePoint Components
Team Site to Modern Team Site Migration SharePoint Sites to Modern Communication Site Migration Promotion of First Level Subsites to Site Collections MySite Migration "Share With" Metadata and "Sharing Links" Access Permissions Migration Records Center to SharePoint Online Migration Using the Import Pipeline Master Page Migration List Template Gallery Migration Content Types Migration Document Version and Checked Out File Limitations Ghosted and Un-Ghosted Page Migration Document Set Migration Navigation Migration Classic Web Parts Migration Site Theme Preservation Site Feature Migration Managed Metadata Migration Users and Permissions Migration BCS/BDC Data Migration OneNote Notebooks Migration Customized Form Pages Migration InfoPath Forms Migration SharePoint Workflow Migration Nintex Workflows and Forms Migration Link Correction StoragePoint Content Migration
Initiating a Migration Configuring Copying Options Saving or Running a Migration Job Copying SharePoint Objects as a Separate Action Configuring Hub Sites Incremental Migration Using PowerShell with Content Matrix
Adding PowerShell Snap-Ins for the Application Framework Content Matrix PowerShell Commandlet List
Metalogix.System.Commands Metalogix.SharePoint.Commands Metalogix.Jobs.Reporting.Commands Metalogix.SharePoint.Migration.Commands
Modifying Content Matrix Configuration and Settings Configuring Content Matrix for Distributed Migration Frequently Asked Questions
DB_Owner Permission Keyboard Shortcuts Activating the License Key Silently License Key Troubleshooting Errors Connecting to SharePoint 2019 or SharePoint Server Subscription Edition in a FIPS-Enabled Environment Determining the Status of a Migration Running in the Background MySite and User Profile Migration Issues Optimal Setup for Best Performance Migrating SharePoint On Premises Using Proxies, Load Balancing or Alternate Access Mappings Extensions Web Service Installation Files Migrating JavaScript Migrating Site Variations Migrating with SharePoint Document IDs Changing a Job Configuration for Multiple Files SharePoint Site Collection Creation Issue Customized Wiki Page Web Part Zones Not Being Migrated Preserving SharePoint List Item IDs When Migrating to SharePoint Online Retrying Failed Document Copies to SharePoint Online CSOM Connections Import Pipeline Batches Getting Stuck Migrating Content When the Source Custom List Template is Missing When Migrating to SharePoint Online HTTP Status Code 429 (“Too many requests”) or 503 (“Server Too Busy”) Message Returned How Do I Identify and Remove Containers and Queues from My Azure Private Storage Account? Error: 'The object is associated with property AssociatedMemberGroup.' Migration Error: 'ERROR, the batch will be resubmitted to the import pipeline' Item Count at Target is Increased When Migrating Using the Import Pipeline Custom Lists with Versioning Enabled Not Being Migrated When Using the Import Pipeline Supported Nintex Actions for SPO Migration Support for GCC High Tenants
About Us

Explicit User Mappings

Explicit user mappings are generally used when trying to migrate a user account that is "orphaned": that is, it exists on the source but is no longer active (or may not be in Active Directory). While the user may not exist, the user’s data may still need to be migrated to the target.

One alternative to adding such an orphaned user to the target is to map the account to another user account. All of the user’s basic metadata would be migrated, but the user name would be populated with the mapped account name instead.

User mappings can also be imported using the Import mappings from XML option.

If you want to map all users (which includes "orphaned" users) from the source domain to a different domain on the target, you can do so using Domain Mappings.

To configure explicit user mappings:

User Mappings

1.In the Specify Global Mappings dialog, make sure the User Mappings tab is selected.

2.From the Source: drop-down on the left side of the dialog, select the source object containing the users you want to map to the target.

The Source list becomes populated with the users that have permissions for that object.

3.Use the information in the following table to determine the appropriate action to take.

If the user ...

Then …

already exists on the target

A.Select the source user that you want to map.

B.From the drop-down on the right (target) side of the dialog, select the target object containing the user to which you want to map.

C.The target list becomes populated with users that have permissions for the selected object.

D.Select the target user to which you want to map the source user.

does not already exist on the target

A.Click Create New User to display the Create New User dialog.

CONTEN~1_img104

B.(Required) Specify a Login Name.

NOTE: This is the most important field as it is used to create/add a new user and should automatically retrieve any necessary values from the target side authenticator.  Be sure to use the appropriate format for the authentication method (for example domain\user name, the Microsoft 365 login name, or, if using Claims authentication, the appropriate Claims prefix and format).

C.(Optional) Complete the Display Name and/or Email fields. If the Login Name does not authenticate for any reason, these fields will be used to fill out the user data.

D.Click [OK].

4.Click Map.

The mapping displays in the lower half of the dialog.

5.Repeat steps 2-4 until you have completed mapping users.

NOTE:  You can map multiple source users to a single target user.

Auto User Mapping

For migrations to SharePoint Online, unless users are mapped explicitly all users will be automatically mapped from a source domain to a domain with the same name on the target.

IMPORTANT: Users will not be automapped if the Import Pipeline is used.

For example, if you are migrating users from an Active Directory domain called quest on the source to users in a Microsoft 365 tenant domain has the same name, the users would be migrated as follows:

quest\amahfudh -> amahfudh@quest.onmicrosoft.com

quest\doconnor -> doconnor@quest.onmicrosoft.com

quest\fsullivan -> fsullivan@quest.onmicrosoft.com

quest\gbond -> gbond@quest.onmicrosoft.com

and so on.

NOTE:  If the source and target domains have different names, you can use Domain Mappings.

To bypass some of the limitations with Auto User Mapping (including use of the Import Pipeline) and to provide more flexible mapping options for both on premises and online targets, you can instead use a utility available from Quest Support to generate, configure, and import User Mappings.

Generating, Configuring, and Importing User Mappings with the UserMappingCLI Utility

Quest Support offers a powerful command line utility to help with automatically generating and configuring user mapping files, along with PowerShell Cmdlets for importing user mappings as a .csv file.  For a copy of the utility with complete instructions, visit https://support.quest.com/content-matrix/kb/311358/best-practices-for-generating-configuring-and-importing-user-mapping.

Domain Mappings

In addition to allowing you to map individual users explicitly, Content Matrix allows you to map all users from one domain to another, across both SharePoint on premises and SharePoint Online environments.  

Domain Mapping can be used in conjunction with explicit user mapping.  For example, you can map all users across a domain, and then map specific users into other user accounts.

NOTE:  Domain mappings can also be imported using the Import mappings from XML option, but Quest recommends the use of the UserMappingCLI utility as the most powerful way to generate, configure, and import user mappings for a variety of scenarios.

 

IMPORTANT:  If you want to migrate an AD group to a Microsoft 365 group that does not already exist on the target site, then you must use the Import mappings from XML option to map the source AD group SID to the target Microsoft 365 group ID.

Specify Global Mapings

 

Connection icon

Domain Mapping supports the following connection types on both source and target:

·SharePoint on premises local and remote (MEWS) Object Model

·SharePoint Online CSOM and the Import Pipeline.

 

NOTE:  If you do not specify an extension for an online domain, .com will be used.  

EXAMPLES:

·If you have an on premises source domain called quest, and you map it to a SharePoint Online target domain called questsoftware.com, you could enter the mapping as shown below.

DomainMapping Wild Card

In this example, users would be migrated as follows:

quest\amahfudh -> amahfudh@questsoftware.com

quest\doconnor -> doconnor@questsoftware.com

quest\fsullivan -> fsullivan@questsoftware.com

quest\gbond -> gbond@questsoftware.com

and so on.

·If you have an on premises source domain called quest, and you map it to a SharePoint Online target domain called questsoftware.net, you would enter the mapping as shown below.

Domain Mapping.net

In this example, users would be migrated as follows:

quest\amahfudh -> amahfudh@questsoftware.net

quest\doconnor -> doconnor@questsoftware.net

quest\fsullivan -> fsullivan@questsoftware.net

quest\gbond -> gbond@questsoftware.net

and so on.

·If you have an online source domain called questsoftware.com and you map it to a target domain called questsoftware.net, you could enter the mapping as shown below.

Domain Mapping SPO to SPO

In this example, users would be migrated as follows:

amahfudh@questsoftware.com -> amahfudh@questsoftware.net

doconnor@questsoftware.com -> doconnor@questsoftware.net

fsullivan@questsoftware.com -> fsullivan@questsoftware.net

gbond@questsoftware.com -> gbond@questsoftware.net

To map domains:

1.In the Specify Global Mappings dialog select the Domain Mappings tab.

2.Click New to display the Create Domain Mapping dialog.

CONTEN~1_img106

3.Enter the Source Domain name and the Target Domain name.  Use the information in the following table for guidance.

Source

Target

Format/Example

On Premises

On Premises

Source Domain: quest

Target Domain:   questsoftware 

NOTES:  When migrating Claims-enabled accounts, remember to include the Claims prefix.  For example: i:0#.w|quest -> i:0#.w|questsoftware.

On Premises

SPO

Source Domain: quest

Target Domain:   questsoftware (or questsoftware.com)

SPO

SPO

Source Domain: questsoftware (or questsoftware.com)

Target Domain:   questsoftware.net

4.Click [OK].

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating