Chat now with support
Chat with Support

Metalogix Content Matrix 8.9 - SharePoint Edition User Guide

Introduction Entering the License Key Content Matrix Console End User Interface Enabling Advanced Mode Connecting to SharePoint Migrating to O365 Using the Azure Pipeline/SPO Containers 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 Document IDs Changing a Job Configuration for Multiple Files SharePoint 2003 Version Migration Limitations SharePoint 2013 and Later 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 "Error, the batch will be resubmitted" Message Displays When Using Azure Item Count at Target is Increased When Migrating Using the Azure Pipeline Custom Lists with Versioning Enabled Not Being Migrated When Using the Azure Pipeline 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

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.

Filter Options

In Metalogix Content Matrix, filters can be set and applied to items within the scope of a migration. Metalogix Content Matrix uses inclusive filters, and these can be added and applied to any level of a migration. Any filters that are set in a migration will be applied to all items within the scope of the migration. Multiple filters can be applied to each level of a migration.

Filter Options

To configure Filter Options:

1.Select the appropriate filter option(s). Use the information in the following table for guidance.

NOTE:  In some cases, when you check one of the filter options users may be prompted with a warning "Information" message regarding workflows. If no workflows are being migrated, click [OK] to continue. If workflows are being migrated, please read the message over and be cautious when setting any filters that they are not part of any migrating workflow.

If …

Select …

·you initiated a site collection- or site-level migration


·you want filters to be applied to child sites within the scope of your migration

Apply filter on Child Sites.

you want filters to apply to items or documents within the scope of the migration

Apply filter on Items and Documents.

·you initiated a site collection- or site-level migration


·you want filters to be applied to lists and libraries within the scope of your migration

Apply filter on Lists and Libraries.


·you initiated a site collection or site-level migration


·you want to exclude selected site columns from the migration

Apply filter on Site Columns.

·you initiated a list-level migration


·you want to exclude selected list columns from the migration

Apply filter on List Columns.

·you initiated a site collection- or site-level migration


·you selected the Copy Other Root Files/Folders option in the Site Options tab


·you want filters to apply to custom folders that exist at the root of a SharePoint site the scope of your migration

Apply filters on Other Root Folders.

·you initiated a site collection- or site-level migration


·you selected the Copy Other Root Files/Folders option in the Site Options tab


·you want filters to apply to custom files that exist at the root of a SharePoint site the scope of your migration

Apply filters on Other Root Files.

2.Follow the procedure for Applying Filter Expressions.  

Applying Filter Expressions

NOTE:  This procedure applies to all filter types except Site Columns and List Columns.

To apply filter expressions:

1.For each option you selected:

a)Click the […] button to the right of the option to display the Filter [Object] dialog.

b)Select a Field (that is, a field column from the source) and Operator, then (depending on the Operator) enter or select a Value.


§Fields are listed by their internal name (and not their display name). The available options in the Operator and Value fields will be based on the Field value that is selected.

§If setting a filter at the Item/Document level, the Field value can be manually entered, and is not limited to the options that are available in the drop down list. This gives the filter a little more flexibility at the Item/Document level.

Filter by Date

2.If you want to add additional expression to the filter:

a)Click [Add Row] or the [Tab] key.

b)Select the appropriate And/Or option:

§If you want the condition to be applied in addition to any filter expressions that precede it, select And.

§If you want to condition to be applied as an alternative to any filter expressions that precede it, select Or value is set, the filter will be added as an alternative filter value.

The Or value is more likely to be used in scenarios where some filters are grouped.

Select/enter a Field, Operator, and Value as described in Step 2(b) above.

Note that, as each expression is applied it displays in the box at the top of the dialog.

3.If you want to group filter expressions, continue with the procedure for “Grouping Filter Expressions,” following.

NOTE: Currently, you cannot change the ordering of filter expressions.  To do so, you must remove then re-add them.

Filter Applied

To remove any filter, select the entire row and open the context menu (by right-clicking), and select Delete Filter(s). Alternately, once a filter row is selected, you can use the [Delete] key. The ordering of filters cannot currently be modified. They would have to be removed and re-added to change the ordering.

Related Documents