Map Users and Groups

Map Users and Groups allows you to replace users that are not valid to existing ones on the destination site so everything works as intended.

Prerequisites

• Global Administrator or SharePoint Administrator permissions are always recommended.

Index

• How-To
• Default Behavior
• Unresolved users or groups
  • Metadata
• Import and Export
• Things to note

How-To

1. Click Migration.
2. Selected the action you want to perform from the Migration menu and connect to a source and a destination.
3. Click  in the top right corner.
4. Select the Users and Groups tab.
5. Search for the user or group in the source and destination.
6. Drag and drop them in the appropriate spot.
7. Click Save.

Default Behavior

Users, groups, and emails are automatically mapped with existing users or groups on the destination site with the same account name (without considering the domain).

If no match is found, the mapping is done by display name. For example, domain1\john will be automatically mapped with domain2\john, since the account name is the same. Also, domain1\john will be automatically mapped with domain2\john-doe if both users' display name is "John Doe".

Unresolved users or groups

You can set a user or group to replace any user or group that existed at the source, but doesn't exist at the destination. A common scenario is between SharePoint environments where some users in the source have left the organization and don't exist on the destination site.

ShareGate Desktop will preserve orphaned users while migrating in Insane Mode to Office 365. To ensure that the mapping of the unresolved users and groups is applied, the migration has to be run in Normal Mode, otherwise, ShareGate Desktop will consider the users as resolved since they can be preserved in Insane Mode.

Metadata

For the Modified By and Created By user fields, unresolved users and groups will be replaced by the migration account when they are not mapped (you will get a warning in your migration report).

Any item that has an unresolved user or group in a custom Person or Group field will fail to migrate when they are not mapped (you will get an error in your migration report).

Import and Export

You can import  or export  from from/to .sgum (Permission Level Mappings file type). This will allow you to save your mappings for future use.

Things to note

• If when migrating from SharePoint to Office 365 you notice some users do not resolve when mapped, it is possible that they did not change their password at first login - causing them to not be provisioned properly.