Chat now with support
Chat with Support

Metalogix Content Matrix 8.9 - eRoom Edition User Guide

Introduction Entering the License Key Content Matrix Console End User Interface Connecting to eRoom Connecting to SharePoint Preparing for Your Migration Initiating a Migration Configuring Copying Options Saving or Running a Migration Action Mapping Links and Running Link Correction Incremental Migration Log Files Using PowerShell with Content Matrix
Configuring PowerShell for Use with Content Matrix
Registering the Metalogix Command DLL Files Adding the PowerShell Snap-Ins for the Application Framework Content Matrix PowerShell Commandlet List
Metalogix.System.Commands Metalogix.SharePoint.Commands Metalogix.Jobs.Reporting.Commands Metalogix.ERoom.Commands
Using Powershell for Nested Content Reports and Pre-Migration Check
Modifying Content Matrix Configuration and Settings Configuring Content Matrix for Distributed Migration Frequently Asked Questions About Us

Using Powershell for Nested Content Reports and Pre-Migration Check

You can perform Pre-Migration Checks, Nested Contents Reports, and Nested Contents URL Length Reports through the PowerShell command window.

In order to create a PowerShell script for a Nested Contents Report or a Pre-Migration Check, Nested Contents URL Report, a report item must first exist in the Job List section.

To create a PowerShell script for Nested Content Reports and Pre-Migration Checks:

1.In the Job List section, select the report(s) want to run in PowerShell.


§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 . Use the information in the following table for guidance.

If you want to generate a PowerShell script …

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 Current 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.



Once the applicable option is selected, Metalogix Content Matrix Console will generate a PowerShell script for the selected report, which will be written to a Notepad file. If multiple reports are selected, they will all be included in that single file.

3.To save the file as a PowerShell script:

a)In the Job List section toolbar, choose File > Save As....

b)In the Save As dialog box, navigate to the directory in which the script file is to be saved.

c)Click the Save as type drop-down menu and select All Files.

d)Enter a name for the script and append the .ps1 file extension to the file name to save it as a PowerShell script.

To run the PowerShell script:

1.Open the Metalogix Content Matrix Console - eRoom Edition PowerShell Console

eRoom PowerShell Console

2.Change the active directory to the file path in which the script file is saved by using the change directory command ("cd <File path>") and then enter ".\" followed by the script name. For example, if your script is named "ResourceScript.ps1", you would enter .\ResourceScript.ps1 to run the script.

NOTE:  If the active directory is different than the directory in which the script file is saved, enter the full file path of the script file relative to your current directory, and then the script file name. For example, if your prompt is at "C:\", your script is named "ResourceScript.ps1", and the script is saved on the desktop, you would enter C:\Users\<User>\Desktop\ResourceScript.ps1 to run the script.

In some cases, the Execution Policy may prevent you from executing a PowerShell script. In this case, you will likely see the following message: [Script].ps1 cannot be loaded because the execution of scripts is disabled on this system. Please see "get-help about_signing" for more details. In this case, run the following command: set-executionpolicy RemoteSigned. This will change the existing script policy to allow you to run these scripts in the specified location. However, it is advised that you check with your System Administrators before doing so to ensure that no Company Policies are being broken by this action.

All Pre-Migration Checks, Nested Contents Reports and Nested Contents URL Reports included in the PowerShell script will run, and any warnings or errors that are encountered while the script runs will be displayed in the PowerShell window.

Modifying Content Matrix Configuration and Settings

You can configure and customize a number of Metalogix Content Matrix settings, including:

·distributed migration configuration

·proxy settings

·available actions and events

·default settings in configuration variable files

·client-side settings

·resource utilization settings

Configuring Proxy Settings

In most cases Metalogix Content Matrix can automatically connect to SharePoint and authenticate license keys, through an environment's proxy setting, However, in some cases the proxy may need to be configured within Metalogix Content Matrix. In these cases users can specify the proxy settings though the connecting dialog.

There are two basic places where this proxy setting can be configured. The first of these is when activating a license key, and the second when connecting to SharePoint. The  dialogs for these options look slightly different, and the when you are using a proxy to connect to SharePoint, you have the additional option to Import Proxy from Internet Explorer.

Proxy Options Blank


NOTE:  For information on setting proxy information when connecting to eRoom, see Connecting to eRoom.

To configure proxy settings:

1.In the Proxy server dialog, check the Enable proxy box.

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

If ...

Then ...

you want to manually enter proxy information

A.Select Enter Manually.

B.Enter the Server name (or IP) and Port for the proxy.

C.Specify the credentials to be used when connecting to the target server.

The Windows authenticated credentials of the current user will be selected by default. You can specify alternate SharePoint credentials by clicking the Different user radio button, and entering an alternate username and password.

Proxy Options Manual

Internet Explorer has been configured to use a proxy server via a proxy auto-configuration (.PAC) file and you want  to connect to SharePoint using this method

select Import Proxy from Internet Explorer.

Proxy Import from IE

NOTE:  This option is currently available only when connecting to SharePoint.

Refer to the Microsoft article Auto proxy configuration settings for Internet Explorer for more information.

3.If you accessed the dialog from the License Activation dialog, click [Set].

NOTE:  If this method does not seem to be working, you can manually configure Metalogix Content Matrix to use a proxy setting.  See Manually Configuring Proxy Settings.

Manually Configuring Proxy Settings

If, for some reason, Metalogix Content Matrix cannot connect through a proxy, then the proxy settings can be configured through the Metalogix Content Matrix UI. If you are not able to configure the proxy settings through the product's UI for some reason, it can be configured manually. The below directions should help you manually configure some explicit proxy settings, enabling the product to work with your proxy.

To manually configure proxy settings:

1.Open the Metalogix Content Matrix Console and add a connection to the desired SharePoint location.

2.After a connection has been added, close Metalogix Content Matrix.

3.Open the ActiveConnections.xml file, which can be found in one of the following locations, in a text editor:

§Microsoft Vista/Windows 7/Windows8/Windows 10 based systems - <DRIVE>:\Users\<USER>\AppData\Roaming\Metalogix\Metalogix Content Matrix Console - <Product> Edition

§Microsoft Windows XP based systems (Windows 98, Windows Me, Windows 2000, Windows 2003, and Windows XP) - <DRIVE>:\Documents and Settings\<USER>\Application Data\Metalogix\Metalogix Content Matrix Console - <Product> Edition

Within the XML file there is a <Connection /> XML element for each added connection. In order for proxy settings to be added to a connection, another element needs to be added inside the connection XML. The added element should be named Proxy, and it should have an attribute named Url. The value for this Url attribute should be the actual URL for the proxy that will be used.

For example, if we are trying to add a proxy connection to the following node:

<Connection NodeType="Metalogix.SharePoint.SPWeb, Metalogix.SharePoint, Version=, Culture=neutral, PublicKeyToken=3b240fac3e39fc03" AdapterType="WS" Url=http://SharePoint2010 />

We would add: <Proxy Url="http://metalogixproxy:8000/" />. So the end result would be:

<Connection NodeType="Metalogix.SharePoint.SPWeb, Metalogix.SharePoint, Version=, Culture=neutral, PublicKeyToken=3b240fac3e39fc03" AdapterType="WS" Url="http://SharePoint2010">

<Proxy Url="http://metalogixproxy:8000/" />


If the proxy connection requires a user name and password that differ from your normal logged in Windows credentials, then these can also be specified in the Proxy element. The attribute UserName can be used to enter a user name (in domain\user format), and an attribute named Password can be used to enter the password value.

In this case the Proxy value <Proxy Url="http://metalogixproxy:8000/" /> would become:

<Proxy Url="http://metalogixproxy:8000/" UserName="DOMAIN\ProxyUser" Password="ProxyPassword" />

4.After these values have been entered to the desired connection, save and close the ActiveConnections.xml file.

5.Re-launch Metalogix Content Matrix.

The connection using the proxy should now be configured, and the connection should be established and working.

Related Documents