These instructions are to be used for interactively (manually) running a Powershell script for the purpose of one-time or periodic extract of Teams Chat communications into a zip file for import into MCO eComms solutions.
The script uses Microsoft PowerShell to call to the M365 compliance center and using Remote Powershell pulls a specified case name using e-discovery tools. Importantly, it requires a user that has compliance center manager rights. (This can be a dedicated account or an existing one with the correct rights). The script will require interactive login through the browser.
To run the script for testing, you will first need to fill out some important details within the PowerShell script. We recommend doing a test run of the script to make sure it is functioning properly. This can consist of just a couple of users at first which we detail below.
Instructions
Prerequisites
Windows OS Enviroment (This can be VM, cloud, local, or server)
PowerShell 7
Install module
ExchangeOnlineManagement
User with Compliance Manager rights granted in Azure AD. (This can be dedicated account or active users account.)
Interactive powershell script, available from MCO support upon request.
Create a distribution group (list)
In order to efficiently administer the users who must have their Teams Chat messages export, the script operates on a distribution group. Later adding and removing users to be exported, is as simple as maintaining this distribution group.
Go to the admin center at https://admin.microsoft.com
In the left-hand panel, select Teams & Groups > Active teams and groups.
Select the Distribution list tab
Click on “Add a distribution list”.
Give the group a name, we recommend “MCO eComms”. Optionally, add a description to this group.
Select an owner for this distro. You must select at least one.
Add users to this distro. The users who are part of this distro will have their Teams messages exported as part of the script.
Set an email address for the team. This will need to be provided in the script for the export to work.
After all the details have been entered, click on “Create Group”.
Create an eDiscovery Case
An eDiscovery Case is used by the powershell script to save search results and, subsequently, support export.
Go to Microsoft Purview.
In the left navigation pane of the Microsoft Purview, click Solutions > eDiscovery.
On the eDiscovery page select Standard Cases option.
Click on “+ Create a case” to initiate the new case flow.
On the New case flyout page, enter a Case Name (required) and optional description.
The case name must be unique in your organization.
We do recommend to name it
MCO eComms Case
Click “Save” to create the case.
The new case is created and displayed on the eDiscovery (Standard) page. (You may have to click “Refresh” to display the new case.)
Customize the Powershell Script
The provided powershell script is to be used as a customizable template enabling customers to tailor it to unique requirements. The following are the configurable attributes within the script. Edit the script using a text editor.
Configurable Parameters | Example Value | Notes |
|
| Days to export. For testing use a shorter duration. Overlapping timeframes are ok as the solution will automatically remove duplicates during import processing. |
|
| Folder where the export is generated on your local computer/server |
|
| Name of the case used to collect search results which will be automatically exported. |
| Comma separated list of distribution groups containing the covered employees to have their chats exported. |
Run the Powershell Script
Once you have created the distribution list, the eDiscovery Case and edited the PowerShell script, run the newly saved script by right-clicking on it in Windows Explorer and selecting "Run with PowerShell". It will open a browser for login using Microsoft credentials.
The script will run for a couple of minutes and, once completed, should generate a .zip file in the location you specified.