Content Matrix 9.9 - File Share Edition

Creating a Support Zip File

You can generate a zip file of data associated with a single migration job to help Quest Support facilitate troubleshooting.

The high-level data collected in the zip file includes:

·Application Settings files.

·Product information (product version, license, etc.).

·Information about the job (what action settings were set, the job log, etc.).

IMPORTANT:  Sensitive Information

Please review the contents of the zip file before sending it to Support.  While this feature attempts to only collect non-sensitive data, no guarantees can be made - it is up to you to ensure that any files in the zip folder are stripped of any confidential data. Regardless, Quest assures that the contents of the zip file will only be used for troubleshooting the associated support ticket.  For added security, Content Matrix removes the encrypted password and token information from the file.  

NOTE: Because passwords are removed, if you try to import a job from a Support zip file and there is no active connection to both the source and target, the import will fail. It is recommended that you create xml jobs using Export to Xml functionality instead of using the xml file generated by the Create Support Zip File operation. Refer to the Knowledge Base article While Importing a Job from a Support Zip File, the error “Could not load data: A password is required” is generated (4369247) (quest.com) for details.

To create a Support zip file:

1.In the Job List, select the job for which the zip file is to be generated.

2.Use one of the following options:

§In the main ribbon, click the Help tab, then Create Support Zip File.

§Right-click and choose Create Support Zip File.

3.Save the file to the desired location using the desired file name.

4.If you wish to review the zip file for sensitive information, click Yes to open the zip file. Once you are satisfied with the contents of the zip file, it can be sent to Quest Support to aid in troubleshooting.

Using PowerShell with Content Matrix

Content Matrix can generate PowerShell scripts to be used to migrate SharePoint content through the PowerShell command window.  You can also use PowerShell to perform other actions, including:

·connecting to SharePoint

·triggering a job in the Content Matrix Console to run

The Content Matrix PowerShell Console shortcut is added to the same Start Menu folder location where the to Content Matrix Consoles are placed after installation. The same PowerShell console can be used for any edition, as long as the edition-specific snap-ins are used.  You can also use a standard PowerShell console or PowerShell ISE.

Content Matrix PowerShell Commandlet List

Content Matrix can generate PowerShell script for you, for any migration action that is available through it. The below cmdlets are used in the generated PowerShell script, but can also be used to write your own script, should you desire to do so. For more information on each cmdlet, simply type get-help [cmdlet]. For example, if you want more information on Copy-MLSharePointList cmdlet you would enter get-help Copy-MLSharePointList, followed by the Enter (return) key.

Below is a list of the available cmdlets (and their parameters), broken up into the available commands for each snap-in.

Adding PowerShell Snap-Ins for the Application Framework

Whenever a new PowerShell session is launched, the edition-specific snap-ins must be added before you can perform a Content Matrix action.

NOTES:

· If you have more than one edition of Content Matrix, only one edition can be run per PowerShell session.

·If Content Matrix settings  is changed, in order to apply new settings all PowerShell sessions must be restarted.  

To add the PowerShell cmdlets for the application framework:

1.Open a Powershell ISE or PowerShell console session.

2.Run the Add-PSSnapin command and by pasting in the following text:

if( $PsVersionTable.PSVersion.Major -lt 3 ) { Write-Host "Windows PowerShell Version 3.0 or later needs to be installed in order to run Content Matrix PowerShell scripts."; exit; }if ( (Get-PSSnapin -Name Metalogix.System.Commands -ErrorAction SilentlyContinue) -eq $null ) { add-pssnapin Metalogix.System.Commands | out-null }if ( (Get-PSSnapin -Name Metalogix.File.Commands -ErrorAction SilentlyContinue) -eq $null ) { add-pssnapin Metalogix.File.Commands | out-null }if (Get-Command Set-MetalogixJobPrerequisites -ErrorAction SilentlyContinue){ Set-MetalogixJobPrerequisites -Value "Content Matrix Console - File Share Edition" }