Chat now with support
Chat with Support

Essentials for Office 365 2.12 - User Guide

Connecting to SharePoint Site or Site Collections Copyright Tool Overview
General Tool Configuration Profile Manager Proxy Mode Azure Turbo and CSOM Creating User Mapping Creating User and Template Reports Support and Troubleshooting Activation Modes of Migration
Home Tab Migration Analysis Tab Migrator Tab
Interface Connect to Resources Copy Sites Live Compare Hyper Mode Classic Mode Copy Alerts Orphaned Users Copy In-Place Tagging of SharePoint Items Incremental/Delta Copy Forms Migration Workflow Migration Save Site to XML
File Manager Tab Drives Tab
Interface Overview Migration Job Structure Connecting to Resources Copy Google Drive Copy File Share Copy My Sites to OneDrive for Business Copy Tenant Copy Box Copy Dropbox Nintex Deployment
Post Migration Compare Security Manager Tab Term Store Manager Tab Administrator Tab Backup Tab
Interface Overview Backup Job Structure Advanced Search Retention Policies Storage for Backup Import/Export Backup Archives Connecting to SharePoint and OneDrive for Business Connecting to Cloud Storage Hyper vs Classic Backup Setup Hyper SharePoint Online Backup Hyper OneDrive Backup Hyper Office 365 Groups Backup Smart Backup Classic SharePoint Online Backup Classic OneDrive Backup Classic Office365 Groups Backup Classic Mailbox Backup Change Properties for Backup Admin Management Scheduling Backup Jobs Backup Project Conversion
Help Tab View Tab Architect Tab Public Folders for SharePoint Tab Scripts Troubleshooting Appendix About

Creating User Mapping

Very often migration scenarios require migrating between different domains. In various scenarios users may not be found and will require a user mapping file.

 

Scenario 1

When performing a migration between resources located in one domain - the user and group accounts are the same, which means you do not need a user mapping file.

 

Scenario 2

When performing a migration between resources with different domains but the same user accounts (for example source jjohnson@contoso-source.com and target is jjohnson@contoso-target.com), you do not need a user mapping file. This is because Essentials will use automated mapping where users are verified on the target via their user account name (jjohnson).
 
However, you would require a mapping file for domain groups, as they use two different syntax forms (for example c:0t.c|tenant|ff6207ef-2987-45ee-bd8f-8011b22bd755), even if the names are the same, the guids are different. As a result, you will be required to create a file where groups will be mapped directly  using wildcard mapping (*@contoso-source.com, *@contoso-target.com).
creating user mapping 1
 

Scenario 3

When performing a migration between resources with different domains and different user accounts (for example your source is jjohnson@contoso-source.com and target is john.johnson@contoso-target.com) you will require a user mapping file for users and groups. Note: if you have a few users with the same user name, you can still use the wildcard mapping format (*@contoso-source.com, *@contoso-target.com)
creating user mapping 2

Mapping for copy from File Share

This option allows administrators to create a mapping report, matching the source file share with Target Office 365 users.

This operation has the following requirements for use:

·The account used to perform the report needs to be a Global Administrator in this Office 365 tenant.

To create a mapping report, perform the following:

1.On the Migration Analysis tab click Mapping Report.
Mapping Report 2
The Mapping Report wizard opens.

2.In the wizard, select the File Share tab.
Mapping Report File Share 1

3.Enter your Domain Controller, domain\login, and password for your file share location. Click Connect.

4.Enter your SharePoint Admin URL for the Target Office 365 connection and click Connect.  On the Connect to SharePoint popup, enter your SharePoint credentials and click Connect. If you receive any message other than "Successfully connected to SharePoint Admin URL", please double check your credentials or contact support. If you would like to add additional Administrator accounts to this report, click Admin+.
user mapping report 4

5.Click the Select button to specify a location and a name for this report.
analyze dropbox4

6.Click Finish to begin the analysis.

7.The report generated will folllow the following rule:
userloginname@*.*, userloginname@*.*
user mapping report 5

8.In order to use the mapping report generated within Essentials, open it in excel, delete the source and target workbook sheets, and the first line with the headers from the user mapping report worksheet. Go to File > Save As> Select file type as CSV UTF-8.

9.You can now use the .csv file in the Copy Tenant wizards, and the Copy My Sites to OneDrive for Business wizard, by selecting Load from CSV on the wizard's first page.
user mapping report 6
 

Please visit the following link for an overview on how to script and schedule jobs such as User Mapping Report.

 

Mapping for copy from Google Drive

The following is a list of steps required to manually create a Google Drive users mapping file.

If you would like to use Essentials to automatically create the user mapping file, see this section.

info

NOTE: The following steps are valid for getting Google Shared Drive users for mapping as well. For details on how to get a list of your Google Shared Drives see this section.

1.To get a list of your source users (Google Drive), open your browser, and log into your Google Drive account with an admin account.

2.Select the Google Apps button, and then Navigate to the Admin option.
Mapping for copy from Google Drive 1
 

3.Select the Users option on the Admin page.
Mapping for copy from Google Drive 2

4.Select the "Download Users" option.
Mapping for copy from Google Drive 8

5.Select CSV as the download format. This will create an Excel/CSV file with your Google Drive user and group information.
Mapping for copy from Google Drive 3

6.In the created CSV, the column titled "Email Address" has a list of all of your Google Drive user and group accounts.
Mapping for copy from Google Drive 4

7.To get a list of your target users, you will be exporting your Office 365 users to a CSV. In your web browser, go to Office 365 online portal and login to your Admin account.

8.Select the Admin option from the available apps.
Mapping for copy from Google Drive 9

9.On the left hand tab, expand the "User" section and select Active Users.
Mapping for copy from Google Drive 10

10.Select the Export Users option. This will create a CSV/Excel file containing your Office 365 active users.
Mapping for copy from Google Drive 11

11. The "UserPrincipalName" section of this CSV file will be your target users accounts.
Mapping for copy from Google Drive 6

12.You are now ready to manually create your user mapping file, using the user names collected from the 2 CSVs from above. The format will be
SourceUser,TargetUser
 
Mapping for copy from Google Drive 7

info

NOTE: For an overview of how to collect Office 365 Groups information for CSV creation, see the second part of this section.

Mapping for copy from Google Shared Drive

To use the Essentials tool to perform this mapping, see the following section.

The following is a list of steps required to manually find a list of your Google Shared Drives for mapping purposes.

1.To get a list of your source Google Shared Drives, open your browser, and log into your Google Shared Drive account with an admin account.

2.There is no way to export a list of your Google Shared Drive IDs through Google Admin, users must manually select each Google Shared Drive, and copy the ID number visible within the individual URLs.

Google Shared Drive Manual Mapping 1

3.To get a list of your target groups, you will be exporting your Office 365 groups to a CSV. In your web browser, go to Office 365 online portal and login to your Admin account.

1.Select the Admin option from the available apps.
Mapping for copy from Google Drive 9

2.On the left hand tab, expand the "Groups" section and select Groups.
manual export groups 1

3.Select the Export Groups option. This will create a CSV/Excel file containing your Office 365 Groups.
manual export groups 2

4. The "GroupPrimaryEmail" section of this CSV file will be your target groups accounts.
manual export groups 3.

4.Once you have a list of your Office 365 groups or your Teams accounts, you are now ready to manually create your user mapping file, using the list of Google Shared Drives and Office 365 Groups or Teams collected in the steps above. The format will be:

Google Shared Drive (unique ID and users), to an Office 365 Group (Office 365 Group Account).
 
0AFQAqumR-AUk9PVA,NikolaPrivate@metavistech.com
Mark@metavist.com,MarketingGroup2015@contoso.com

info

NOTE:  Google Shared Drive IDs are case-sensitive.  Make sure each ID is exactly as it appears in the URL copied in Step 2.

Members Permission Levels Mapping:

Google Shared Drive

Office 365

Manager  

Groups Owner

Content Manager

Groups Member

Contributor

Groups Member

Commenter

Groups Member

Viewer

Groups Member

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating