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

Initiating a Scheduled Task

1.Select the newly added migration job in the Job List section.

2.Use the information in the following table to determine the appropriate action to take.

If you want to create a scheduled task …

Then …

Through the Metalogix Content Matrix Console UI


§Click the [Schedule Task] button in the Job List menu options


§Right-click and choose Schedule Task.

Directly in the Windows Task Scheduler


§Click the [Generate PowerShell Script] button in the Job List menu options


§Right-click and choose Generate PowerShell Script.

3.Choose the appropriate option from the sub-menu to specify the security method that will be used when generating the PowerShell script to run the scheduled task. Use the information in the following table for guidance.

If you want to generate a PowerShell script for scheduling …

Choose …

that can be used only by the currently logged in User Account on the machine it is generated on

For Current User and Machine.

NOTE:  Any PowerShell scripts that are generated for scheduling through this option can only be run by the logged in user on the machine they were generated on.

that can be used by any User account on the machine it is generated on

For Local Machine.

that can be used by any User account on any machine that has the certificate that is specified when the script is created

For Certificate.

When you save the PowerShell script using this method you will be prompted to select a security certificate that exist on that machine. The selected certificate will be required on any system that attempts to run the script at a later date.



4.Use the information in the table below to determine the appropriate action to take based on the option you chose.

If you chose …

Then …

Schedule Task

 When prompted, save the PowerShell script to a desired location; by default:

·For scripts generated using the For Current User and Machine option - <Drive>:\Users\<Username>\Documents\Metalogix\PowerShell.

·For scripts generated using the For Current Machine or For Certificate options - <Drive>:\ProgramData\Metalogix\PowerShell

Generate Powershell Script

a Notepad file containing the PowerShell script opens.

Save this file to the location from where you want the script to run, and give it an appropriate name (being sure to keep the ".ps1" extension).

Continue with the procedure for Scheduling a Migration Job via the Windows Task Scheduler.


Scheduling a Migration Job via the Content Matrix UI

If you chose the Schedule Task option (that is, to schedule a migration job via the UI), once PowerShell script has been saved the Create Task Wizard dialog opens, allowing you to start configuring the scheduling for the migration task.

1.Complete the Create Task Wizard as follows:

a)Enter a desired name for the scheduled task in the Task Name field.

The Description section displays some additional details about migration action, such as the source and target locations.


Click [Next].

Set the Trigger for the scheduled task. Use the information in the following table for guidance.


If you want the scheduled job to run …

Select …

at the same time every day


whenever a specific system event is logged

When a specific event is logged.

on specified days during specified months


one time only at a specific date/time

One Time.

on one or more specified days on the week


2.Click [Next].

3.Use the information in the following table to determine the appropriate action to take.

If you selected …

Then …


·Select a Start date and time, and

·For Recur every….days, select the interval at which you want the job to run.


When a specific event is logged

·Select the Log from which you want Metalogix Content Matrix to search for the event.

·Select the Source program, application, or service from which the Logs are filed.

·Enter the specific Event ID used trigger the scheduled task.




·Select a Start date and time.

·From the Months drop-down, use the checkboxes to select/deselect the months during which you want the scheduled task to run.


·Select the appropriate option:

§If you want the scheduled task to run on specific calendar days, select the Days radio button, and from the drop-down use the checkboxes to select/deselect the days when you want the scheduled task to run.


§If you want the scheduled task to run on specific days of the week, select the On radio button, and from the drop-downs select the frequency and week day(s).


For example, if first, third and last are selected in the first drop down menu, and Monday and Thursday are selected in the second drop down menu. the scheduled task will be run on the first, third, and last Monday of the month, as well as the first, third, and last Thursday of the month.


One Time

Select a Start date and time.



·Select a Start date and time.

·For Recur every n weeks on:

§Specify how often the scheduled task should occur.

For example, if the value is set to 5 then the scheduled task will run on every fifth week. If the value is set to 2 then the task will be run every other (every second) week.

§Check each day of the week on which you want the task to run.

For example, if the Recur every value is set to "3" and the day is set to "Wednesday", then on every third week the scheduled task will be run on Wednesday at the entered value for the start time. If the recur value is set to "1" and both "Wednesday" and "Sunday" have been selected, then the scheduled task will be run on Sunday and Wednesday of every week.



A Summary of the scheduled task displays. If the summary looks correct, click the Finish button to complete the scheduling of the migration task. The task will now be added in the Windows Task Scheduler under a Metalogix folder.  (You may need to Refresh the Windows Task Scheduler dialog before the scheduled tasks will be displayed.)

Viewing the scheduled task, making any modifications or deleting the task itself must be done from within the Windows Task Scheduler, which can be accessed via the Metalogix Content Matrix Console’s Jobs List section Scheduled Task >


After a scheduled task has been run, a new entry for the migration will be added into the  Job List section.

Scheduling a Migration Job via the Windows Task Scheduler

If you chose the Generate PowerShell Script option (that is, to configure the migration job directly in the Windows Task Scheduler) and saved the PowerShell script to the location of your choice, follow the steps below.

1.On the system where the scheduled task will run, open the Windows Task Scheduler.

2.Choose Actions > Create Task.

3.Enter a task Name and Description.

4.In the General tab, go to Security options and specify the user account that the task should be run under. Change the settings so the task will run regardless of whether the user is logged in.

5.Select the Triggers tab, and click [New] to add a new trigger for the scheduled task. This new task should use the On a schedule option. The start date can be set to a desired time, and the frequency and duration of the task can be set based on your specific needs. Click [OK] when your desired settings are entered.

6.Select the Actions tab and click [New] to set the action for this task to run. Set the Action to Start a program.

7.In the Program/script box enter "PowerShell."

8.In the Add arguments (optional) box enter the value ".\[Your PowerShell Script Name]." For example, if your PowerShell Script is named "Migration1.ps1" then you would enter ".\Migration1.ps1" as the value.

9.In the Start in (optional) box, add the location of the folder that contains your PowerShell script.

NOTE:  The location used in the Start in box will also be used for storing the scheduled task run times, the job history for the copies, and any additional logging that may occur.

10.When all the desired settings are made, click [OK].

11.Next, set any other desired settings in the Conditions and Settings tabs. You can also set up additional actions, such as emailing an Administrator each time the script is run.

12.Once all the desired actions have been made (or added), click [OK].

The task will be immediately set, and is ready to run.

Refreshing the Jobs List

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

To refresh the jobs 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 Jobs 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.

Related Documents