Exchange Online Clutter

Clutter is a new productivity aid in Exchange Online that helps save you time by separating your important messages from the rest of the muck that you get on a daily basis. A description of how this feature works can be found here. Clutter is optional and can be enabled by users should they choose to use the service.

Microsoft believes in Clutter so much, however, that they have decided to make it available by default on all new Exchange Online mailboxes starting in June. If this timeline doesn’t work for your organization, or you would rather give your users the choice to turn Clutter on, there are some new PowerShell cmdlets that you can leverage.

First, some prerequisites:

  1. You need to have an account that has at least the Exchange Service Administrator role in Office 365 and the ability to connect to Exchange Online with PowerShell. Instructions to connect can be found here. I also have a module on Github that can make working with Exchange Online and other Office 365 services a bit easier.

  2. The Clutter cmdlets will only work on server version 15.1 (Build 166.22). To manage Clutter with PowerShell, both the server that you connect to via PowerShell and the server that the mailboxes you are managing must be updated to this version. Microsoft is working to make sure that all Exchange Online servers are updated as quickly as possible, but you may still have some mailboxes that are on a prior version. If this is the case you will get an error when targeting those mailboxes with the Clutter cmdlets:

Error on proxy command 'Get-Clutter -Identity:'user@domainname.onmicrosoft.com,OU=Microsoft Exchange Hosted Organizations,DC=NAMPR123h050,DC=prod,DC=outlook,DC=com'' to
server servname.namprd77.prod.outlook.com: Server version 15.01.0154.0000, Proxy method PSWS:
Cmdlet error with following error message:
System.Management.Automation.parentContainsErrorRecordException: The term 'Get-clutter' is not recognized as the name of a cmdlet, function, script file, or operable program. Check the spelling of the name, or if a path was included, verify that the path is correct and try again.
    + Category Info         : NotSpecified: (:) [Get-Clutter], CmdletProxyException
    + FullyQua1ifiedErrorId : [Server-BY2PR023408h,RequestId=z25268ceb-120e-4f43-9b35-33Ec0ac02c5,Timestamp=5/25/2015 1:42:.27 PM [Failurecategoryzcmdlet-cmdletproxyexception] 5FE2AEFD,Microsoft.Exchange.Management.powershell.Support.GetC1utter
    + PSComputerName        : pod15150.psh.outlook.com

Turning Clutter Off

There is currently no way to disable Clutter from being on by default for your entire tenant - you will have to do this for all your mailboxes now and for any new mailboxes that you don’t want to have Clutter turned on for.  You can disable Clutter manually for a mailbox by running the Set-Clutter cmdlet:

PS> Get-Mailbox 'Abe Lincoln' | Set-Clutter -Enable $false

Or you can disable it for all mailboxes:

PS> Get-Mailbox -Filter * -ResultSize Unlimited | Set-Clutter -Enable $false

However, some of your users may have already enabled Clutter and you won’t want to disable it for them. In this case you will want to filter your mailbox results to only the mailboxes that don’t already have Clutter enabled:

You can fully automate disabling Clutter for your current mailboxes using this script. Make sure you unblock the script and then run:

PS> Get-Help .\DisableClutterOnByDefault.ps1 -ShowWindow

for details on how to use the script.

Moving Forward

After you have run the above commands to disable the Clutter for the desired mailboxes, you’ll need a plan to sustain this policy for future mailboxes. If you automate mailbox creations with PowerShell, then you’ll need to run Set-Clutter against each one to disable Clutter by default. At some point you may want to embrace the on by default strategy and make your users aware of the change. At that point you can just allow new mailboxes to have this enabled.

I hope this post has clarified the administrative controls for Clutter and will help your organization make it’s decision around this new feature.