Manage Clutter by using PowerShell | Office 365 5/5 (1) 9 min read

Clutter is a new Exchange server feature that created for facilitating better and more efficient mailbox management by Exchange users.

The Clutter feature is implemented by analyzing the Exchange mailbox data and based on a “learning process” and other algorithmic decide which of the mail items is “less important.”

The Clutter mechanism will relocate this “less important” mail items into the Clutter folder. The mail items are not deleted by instead, “removed” from the inbox mail folder and by doing so, enable to user to focus solely on important mail items.

A few words from a Microsoft article:

Last fall, we introduced Clutter, which moves less important emails out of your inbox and keeps you focused what’s most important to you. Today Clutter is moving over one million emails per day and saves users 82 minutes per month on average. Starting in June, Clutter will be on by default to help more people benefit from Clutter. We’re also introducing new administrative controls for Clutter and improving how Clutter interacts with users.

[Source of information: De-Cluttering everyone’s inbox]

PowerShell | Help & additional information

Running PowerShell commands in Office 365 based environment
To be able to run the PowerShell commands specified in the current article, you will need to create a remote PowerShell with Azure Active Directory or Exchange Online. In case that you need help with the process of creating a Remote PowerShell session, you can use the links on the bottom of the Article.

SECTION A: Assign (Enable) Clutter for mailbox or mailboxes

Enable clutter for a specific mailbox

PowerShell command syntax

PowerShell command Example

Enable Clutter for of ALL mailboxes that dont use Clutter (Bulk mode)

PowerShell command Example

Enable Clutter for ALL users mailboxes (Bulk mode)

PowerShell command Example

SECTION B: Display information about clutter settings

Display information about – clutter settings for a specific mailbox

PowerShell command syntax

PowerShell command Example

Display information about – Clutter settings for a ALL mailboxes (Bulk mode)

PowerShell command Example

Display information about – Mailboxes with Clutter Enabled and Mailboxes with Clutter Disabled

PowerShell command Example

Display information about – Mailboxes with Clutter Enabled and Mailboxes with Clutter Enabled

PowerShell command Example

Display information about – Clutter folder – number of items and size

PowerShell command Example

SECTION C: Disable mailbox Clutter

Disable Clutter for a specific mailbox

PowerShell command syntax

PowerShell command Example

Disable clutter for ALL users mailboxes (Bulk mode)

PowerShell command Example

SECTION D: Export information about Clutter settings

Export information about – Clutter settings for a specific mailbox to CSV file

PowerShell command Example

PowerShell command Example

Export information about – Mailboxes with Clutter Disabled to CSV file

PowerShell command Example

Export information about – Mailboxes with Clutter Enabled to CSV file

PowerShell command Example

Export information about – Clutter folder – number of items and size

PowerShell command Example

SECTION E: Using Exchange Online rule to bypass clutter

Using Exchange Online rule to bypass clutter

When using clutter option, the Exchange server who manages the user mailbox, “decide” according to an internal algorithm to “move” (or not to “move”) a specific E-mail message to the clutter folder.

In some scenarios, the clutter algorithm can decide to classify E-mail messages as an E-mail that will be sent to the clutter folder, and we would like to override this decision.

To be able to “inform” Exchange server that we would like to prevent that clutter process for specific mail items, we can create an Exchange Online rule.

The Exchange rule is implemented by, defining the characters of this specific emails, and asks from Exchange to add a specific mail field to the E-mail message header.

This special mail filed is named – X-MS-Exchange-Organization-BypassClutter.

We will need to add this mail field, and set the value of this mail field to “true

For example

X-MS-Exchange-Organization-BypassClutter = true

In case that Exchange server “locate” this mail field, he “understands” that he needs to Bypass the clutter process.

The Exchange rule can be created manually or via PowerShell.

In the following section, we review two examples of such as Exchange rule that will bypass the clutter of specific mail items.

Create Exchange rule that will bypass the clutter for E-mail that include a specific text in the mail SUBJECT

PowerShell command syntax

PowerShell command Example

Create Exchange rule that will bypass clutter for E-mail that sent from a specific SENDER

PowerShell command syntax

PowerShell command Example

For your convenience, I have “Wrapped” all the PowerShell commands that were reviewed in the article,
in a “Menu Based” PowerShell Script.

You are welcome to download the PowerShell script and use it.
Download -o365info PowerShell Script

Manage Clutter by using PowerShell | Office 365
In case you want to get more detailed information about how to use the o365info menu PowerShell script, you can read the following article


Getting started with Office 365 PowerShell

PowerShell Naming Conventions & general information
Get more information about the Naming Conventions that are used in the PowerShell articles – Help and additional information – o365info.com PowerShell articles
Creating a remote PowerShell session to Exchange Online 
To get more information about the required remote PowerShell commands that you need to use for connecting to Exchange Online, read the following article:
Connect to Exchange Online by using Remote PowerShell
Creating a remote PowerShell session to Azure Active Directory
To get more information about the required software component + the remote PowerShell commands that you need to use for connecting Azure Active Directory, read the following article: Part 2: Connect to Office 365 by using Remote PowerShell
Basic introduction to PowerShell in Office 365 based environment
If you are new in the PowerShell world, you can read more information about how to start working with PowerShell in Office 365 based environment in the following article series:  Getting started with Office 365 PowerShell – Part 1, Part 2, Part 3.
Running and using o365info PowerShell scripts
In case that you need more information about how to use the o365info PowerShell scripts that I add to the PowerShell articles, you can read the article – How to run and use o365info PowerShell menu script

PowerShell command syntax – Office 365 | Article series index

Now it’s Your Turn!
It is important for us to know your opinion on this article

Print Friendly, PDF & Email

Related Post

Please rate this

Eyal Doron on EmailEyal Doron on FacebookEyal Doron on GoogleEyal Doron on LinkedinEyal Doron on PinterestEyal Doron on RssEyal Doron on TwitterEyal Doron on WordpressEyal Doron on Youtube
Eyal Doron
Share your knowledge.
It’s a way to achieve immortality.
Dalai Lama

2 Responses to “Manage Clutter by using PowerShell | Office 365”

  1. Thank you Eyal!!! The PS menu script you wrote is perfect, and solved a number of my issues.

  2. Hello Eyal,

    i have a specific requirement, i have few commands, that i have put together but i am not seeing the desired results. i am no genius when writing a script. it would be great if you can help me with this.

    i get the output of this,

    [String]$ExclusionGroupDN = (Get-DistributionGroup “Test Distribution list”).DistinguishedName
    Get-DistributionGroupMember $ExclusionGroupDN
    $ClutterDis = Get-Mailbox -Filter {MemberOfGroup -NotLike $ExclusionGroupDN } -ResultSize Unlimited | Where {$_.WhenCreated -gt(get-date).AddDays(-7)}.

    but when i add

    $ClutterDis=Get-Mailbox -ResultSize unlimited | Where-Object {$_.WhenCreated –gt ((Get-Date).Adddays(-7))} | Where-Object {(Get-Clutter -Identity $_.alias).IsEnabled -eq $True}

    thats when things dont work as they are expected. can this be modified to show only the items that have clutter enabled and are not a part of the distribution list that i am going to specify?

Leave a Reply

Your email address will not be published. Required fields are marked *