Chat now with support
Chat with Support

Content Matrix 9.9 - 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 2013 and Later 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

Importing Jobs from Xml Using PowerShell

Navigation:  Saving or Running a Migration Job > Importing and Exporting Migration Jobs Using Xml Files >

Importing Jobs from Xml Using PowerShell

You can import jobs that have been previously exported to xml using PowerShell.

To access the PowerShell cmdlets for connecting to SharePoint:

Open a PowerShell or PowerShell ISE session and add the PowerShell snap-ins for the application framework.

To import jobs from an xml file:

1.Select (from the PowerShell ISE Command Window) or enter Load-JobXml.

2.Select or enter the applicable parameters.  Use the information in the following table for guidance.





The path to the xml file containing the job(s) you want to import.



If you use this parameter and the job already exists in the Jobs Database, it will be imported with a new Job ID.

If you omit this parameter and the job already exists in the Jobs Database, it will not be imported. For an xml file that contains multiple jobs, only those that are not in the Jobs Database will be imported.  If trace logging is enabled, the detail will be logged in the file MetalogixGlobalLog.txt.

XML Job Import Error

Example Scripts with Results:  

With ImportDuplicate parameter

Load-JobXml -XmlFilePath C:\Users\Administrator\Desktop\MigrateToSPO.xml -ImportDuplicate

6 job(s) successfully imported out of a total of 6 job(s), in 0m 0s


Without ImportDuplicate parameter

Load-JobXml -XmlFilePath C:\Users\Administrator\Desktop\MigrateToSPO.xml

4 job(s) successfully imported out of a total of 6 job(s), in 0m 0s

Refreshing the Jobs List

Navigation:  Saving or Running a Migration Job >

Refreshing the Job List

NOTE:  The refresh is applied to whichever job list Content Matrix is currently connected to, whether that is the Distributed Database (for the Distributed Migration feature) or via a standard connection.

To refresh the Job List:

1.From the Manage Queue dialog, select a job in the Job List.  The row selector icon and the highlighted row indicates the selected row.

2.From the Job List menu bar, choose File > Refresh.

If the status of the job has changed, the Status value will indicate the new status of the job.

Submitting a Distributed Migration Job

Navigation:  Saving or Running a Migration Job >

Submitting a Distributed Migration Job

If the Content Matrix Console is configured for Distributed Migration, you can run a job remotely, on a Distributed Migration agent machine.

Distributed Migration Job Limitations

Navigation:  Saving or Running a Migration Job > Submitting a Distributed Migration Job >

Distributed Migration Job Limitations

Connection icon

· If a migration job is using SP 2013 or later DB as a source connection, then users can only run jobs remotely on an agent that meets the connection requirements for the same DB version as the machine from which the migration is configured. This means that the agent machines must either:

§Have the same version of SharePoint installed on or be a SharePoint WFE for a comptible version.


§Be a 64-bit machine that has no version of SharePoint installed on it.

·Local Object Model (OM) connections to SharePoint are not supported when using Remote Agents. - A Local OM connection to SharePoint can only be made when Content Matrix is installed on a machine that is running SharePoint (a SharePoint server or WFE). Since this type of connection can be made on the Host machine, but cannot be guaranteed to also be available on an agent machine, it is not a supported connection adapter for running migrations using remote Agents.  For making remote Object Model connections, make sure the Metalogix Extension Web Service (MEWS) is installed on each agent machine.  

·The following Authentication types are not supported:

·Forms based Authentication

·Web browser Authentication

·Microsoft 365 Web browser authentication

·Transformer scripts will not work using a remote agent if the script is used as an attachment (i.e. if the script is stored as a file on the local file system, and added to the migration configuration as an attachment) - When running a migration, uses can go to the 'Transformations' tab in the configuration options and set the migration to use a transformer. If the transformer is added by using the Invoke PowerShell script > Use Script From File option, then the transformer will be added by selecting a script file from the file system and attaching it to the configuration options. Transformer script files that are attached in this manner do not get transferred to the agent machines, so when the agent tries to run the migration it will run without the configured transformer script.

·If an action in Content Matrix is not supported for generating/running the action over PowerShell, then that action is not supported to run remotely on an agent machine. - Not all actions in Content Matrix are supported when using PowerShell. Since running a migration on a remote agent relies on PowerShell, some actions are not supported to be run remotely. For example:

§Copy Site > Paste Site Objects > List E-mail Notification

§Copy Site > Paste Site Objects > Managed Metadata Local Site Collection Group

§Copy Site > Paste Site Objects > Managed Metadata Term Store

§Copy Site > Paste Site Objects > Site column

§Copy List > Paste List Objects > Permission

·Currently, Distributed Migration does not support External Connections (which are needed to migrate Nintex Workflows/Forms and BDC and BCS Data)

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating