Chat now with support
Chat with Support

Metalogix Content Matrix 8.8 - SharePoint Edition User Guide

Introduction Entering the License Key Content Matrix Console End User Interface Enabling Advanced Mode Connecting to SharePoint Preparing for a Migration How Content Matrix Handles Various SharePoint Components Initiating a Migration Configuring Copying Options Saving or Running a Migration Action Copying SharePoint Objects as a Separate Action Self-Service Migration Incremental Migration Log Files Using PowerShell with Content Matrix
Configuring PowerShell for Use with Content Matrix
Registering Metalogix Command DLL Files 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 and Self-Service Migration Frequently Asked Questions
DB_Owner Permission Migrating with the Fabulous 40 Templates Item Count Discrepancies Keyboard Shortcuts License Key Troubleshooting Determining the Status of a Migration Running in the Background MySite and User Profile Migration Issues Optimal Setup for Best Performance Using Proxies, Load Balancing or Alternate Access Mappings Troubleshooting the Extensions Web Service Installing the Extensions Web Service on Specific Systems Extensions Web Service Installation Files Using Older Versions of the Extensions Web Service Preserving IDs when Migrating a Custom List as a Folder Migrating JavaScript Migrating Site Variations Migrating with SharePoint 2010/2013/2016 Document IDs Changing a Job Configuration for Multiple Files SharePoint 2003 Version Migration Limitations SharePoint 2013 and 2016 Site Collection Creation Issue Job List Database fails to Load After Upgrade Customized Wiki Page Web Part Zones Not Being Migrated Preserving SharePoint List Item IDs with a CSOM Connection Type Retrying Failed Document Copies to O365 CSOM Connections Migrating Content When the Source Custom List Template is Missing Are SharePoint Online Migrations Throttled? What to Expect when Migrating with StoragePoint on the Target Migration Error Message 'There was an Error Reading from the Pipe: The Pipe has been Ended (109, 0xd6)' How do I Remove Items from My Azure Blob Storage Account? Azure Batches Getting Stuck Supported Nintex Actions for SPO Migration "Insufficient Credentials" Message Connecting to Modern Team Site Using Web Browser Authentication Error Making a Browser-Based Connection with PowerShell Console Open
About Us

Domain Mappings

In addition to allowing you to map individual users explicitly, Metalogix 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.

Advanced Mode Icon  This option is only available when Advanced Mode is enabled.

NOTE:  Domain mappings can also be imported using the Import mappings from XML option.

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 Azure/SPO Container.


if you have an on-premises source domain called metalogix, and you map it to a SharePoint Online target domain called metalogixsoftware, you would enter the mapping as shown below.

DomainMapping Wild Card

In this example, users would be migrated as follows:

metalogix\amahfudh ->

metalogix\doconnor ->

metalogix\fsullivan ->

metalogix\gbond ->

and so on.

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.


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




On Premises

On Premises

Source Domain: metalogix

Target Domain:   metalogixsoftware 

NOTE:  When migrating Claims-enabled accounts, remember to include the Claims prefix.  For example: i:0#.w|metalogix -> i:0#.w|metalogixsoftware

On Premises


Source Domain: metalogix

Target Domain:   metalogixsoftware.onmicrosoft



Source Domain: metalogix.onmicrosoft

Target Domain:   metalogixsoftware.onmicrosoft


On Premises

Source Domain: metalogix.onmicrosoft

Target Domain:   metalogixsoftware

4.Click [OK].

URL Mappings

Metalogix Content Matrix can set explicit mappings for URLs which can be used with link correction.  While link correction only applies to the content that exists within the scope of the migration, URL mapping can help by-pass this issue for any mappings that are specifically set.

Advanced Mode Icon  This option is only available when Advanced Mode is enabled.

For example, if there is a link within some content that is being migrated, and this link points to a URL location that is outside of the migrating content, a URL mapping can be set up for it. Then after migration, this link will point to the URL that the mapping was set up for, despite the target URL being outside the scope of the migrating content. If there are any other links to content that exists under the location that the URL is mapped to, the links to that sub-content will be corrected as well. For example, if a URL mapping is set to a document library in a location that is outside the scope of the current migration, the URL mapping will correct the links that point to this document library. In addition, any links within the migrating content that are pointing to any folders or documents within the document library will also be corrected. Links that point to that document library's site, or other lists in the same site, will not be corrected.

The URL mapping behavior may change if the URLs being mapped exist within the scope of the migration. In this case the link correction within Metalogix Content Matrix will likely override the URL mapping, if the source link has a mapping created for it through the normal link correction process.

You have the option of using the Sites, Lists, and Folders renamed on target option. This option allows you to specify any sites, lists, or folders that may have been renamed during migration. This is only used for link correction purposes, and will not actually rename any sites, lists, or folders

For example, if a site was renamed during migration, this renaming would be entered here so that the link correction would be able to correctly identify the site and correct all the necessary navigation links for it, during the navigation copy.

You can add as many additional mappings as desired. You can also map a single source URL to multiple target URLs.

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

To map URLs:

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


2.In the Source Address column enter the URL for the source location.

This must be a full URL, and cannot be a relative URL. For example, "http://OldServer/Sales/FactsAndFigures" would be a valid URL value, while "./Sales/FactsAndFigures" or "www.OldServer/Sales/FactsAndFigures" would both be considered relative or invalid URL values.

3.Enter a value in the Target Address column.

This is the same relative address as the Source Address, but using the location of the target side URL.

NOTE: Metalogix Content Matrix will check to see if any entered values in the URL mappings window are valid. This check will ignore any letter case differences or encoding (meaning that "encoding space" and "encoding%20space" are viewed as the same). It should also be noted that spaces in the hostname of the URL are not considered valid. This check applies to both the Source Address and Target Address columns.

4.Click [OK] to return to the Specify Global Mappings dialog.





GUID Mappings

While this feature is not required in most migration cases, there are some scenarios that may require GUID mapping for successful migration of SharePoint objects, like web parts.  GUID mapping will replace the specified GUID from the source with a different GUID on the target SharePoint environment.

Advanced Mode Icon  This option is only available when Advanced Mode is enabled.

Metalogix Content Matrix will check the GUIDs to see if any entered values in the GUID mappings window are valid. This check will ignore any letter case differences or brackets ("{}").A   warning message will be given for any entered GUID values that are not valid.

NOTE:  One source GUID can be mapped to a single target GUID, or multiple source GUIDs can be mapped to a single target GUID.

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

To create a GUID mapping:

1.From the Specify Global Mappings dialog, select the GUID Mapping tab.


2.For each GUID you want to map:

a)In the Source GUID column enter a valid GUID from the source location.

b)In the Target GUID column, enter the replacement value for the target side.

3.When you have finished mapping GUIDs, click [OK].

When running a migration, if the migration action itself creates a mapping for a GUID value that is already mapped (though the GUID Mappings tab), the mapping from the migration will be used instead of the manually set mapping.

Importing Mappings from an xml File

Metalogix Content Matrix can import any desired user mappings from an XML file. Importing user mappings from an XML file involves creating an XML file with the desired mappings, then importing that file. This option is generally used if migrating from an  environment that has a large number of users/groups.

A single XML file can include: User mappings, Domain mappings, URL mappings, and GUID mappings. However, each type of mapping must have its own child node. The format for these child nodes is:

·User Mapping - <Mapping Source="Domain\User1" Target="Domain\User2" />

·Domain Mapping - <DomainMapping Source="Domain1" Target="Domain2" />

·URL Mapping - <UrlMapping Source="URL1" Target="URL2" />

·GUID Mapping - <GuidMapping Source="GUID1" Target="GUID2" />

NOTE:  The Import mappings from XML feature is also fully backward compatible with the previous version of Metalogix Content Matrix’s UserMappings.XML file. So any user mappings set in the previous (old framework) version of Metalogix Content Matrix’s UserMappings.XML file can be imported into the User Mappings.

To Import Mappings from an XML file:

1.Create a file, with any name, that contains any desired user or permissions mappings.

The file must be an XML file, and must contain a root level node named Mappings, and have one child node for every mapping that you want imported. Each child node must contain two attributes: Source and Target.


In the case of a mapping, The Source is the Login Name of the source side user, and the Target attribute is the Login Name of the target user that is being mapped to.  Note that if you are mapping AD groups, you must use the group's SID in the mapping:


<Mapping Source="Metalogix\User1" Target="Metalogix\User87" />

<Mapping Source="Metalogix\User2" Target="Metalogix\User254" />

<Mapping Source="[SID]" Target="[SID]" />


2.From the Specify Global Mappings dialog, click [Import mappings from XML] to open the Select xml file to import dialog.

3.Browse to and select the xml file you want to import, then click [Open].


The mappings will be sorted and appear in the appropriate tabs of the Specify Global Mappings dialog.

Related Documents