In the current article, we review how to manage the option of – Focused Inbox in Office 365 by using PowerShell.
Generally speaking, we can enable or disable the option Focused Inbox in “organization level” by using the PowerShell cmdlet – Get-OrganizationConfig or by managing single Exchange mailbox” by using the PowerShell cmdlet – Set-FocusedInbox
Table of content
What is the purpose of the Focused Inbox feature?
Focused Inbox—focus on the emails that matter most
For many, the inbox is the command center for their day. It’s the way to keep track of what is going on and what needs to get done. Outlook’s Focused Inbox makes this process easier by helping you focus on the emails that matter most to you. It separates your inbox into two tabs—Focused and Other. Emails that matter most to you are in the Focused tab, while the rest remain easily accessible—but out of the way in the Other tab. You’ll be informed about email flowing to “Other”, and you can switch between tabs at any time to take a quick look.
For more about what makes Focused Inbox great, see Outlook helps you focus on what matters to you.
[Source of information – Managing Focused Inbox in Office 365 and Outlook]
Transition from Clutter to Focused Inbox in Office 365
Users can keep using the existing Clutter experience through the transition. However, after the transition period, Clutter will be completely replaced by Focused Inbox.
In the meantime, if a Clutter user chooses to opt-in to using Focused Inbox they will no longer receive the less important email in the “Clutter” folder.
Instead, the email will be split between the Focused and Other tabs in their inbox. Tenant admins will be proactively notified before Clutter is fully replaced.
[Source of information – Managing Focused Inbox in Office 365 and Outlook]
SECTION A: Enable “Focused Inbox” option
Enable Focused Inbox option | Organization level
When using the PowerShell cmdlet – Set-OrganizationConfig, the option of Focused Inbox will be applied (activated) for all existing Exchange mailboxes + to all NEW Exchange mailboxes that will be created in the Future.
In case that we want to Disable the option of Focused Inbox for a specific Exchange mailbox, we can use the PowerShell cmdlet – Set-FocusedInbox
PowerShell command Example
1 | Set-OrganizationConfig -FocusedInboxOn $True |
Enable Focused Inbox | Single Mailbox
PowerShell command syntax
1 | Set-FocusedInbox -Identity <Mailbox> -FocusedInboxOn $True |
PowerShell command Example
1 | Set-FocusedInbox -Identity Bob -FocusedInboxOn $True |
Enable Focused Inbox | All Exchange USER Mailboxes (Bulk)
PowerShell command Example
1 | Get-MailBox -Filter '(RecipientTypeDetails -eq "UserMailbox")' | Set-FocusedInbox -FocusedInboxOn $True |
SECTION B: Disable “Focused Inbox” option
Disable Focused Inbox | Organization level
When using the PowerShell cmdlet – Set-OrganizationConfig, the option of Focused Inbox will be applied (activated) for all existing Exchange mailboxes + to all NEW Exchange mailboxes that will be created in the Future.
In case that we want to Enable the option of Focused Inbox for a specific Exchange mailbox, we can use the PowerShell cmdlet – Set-FocusedInbox
PowerShell command Example
1 | Set-OrganizationConfig -FocusedInboxOn $False |
Disable Focused Inbox | Single Mailbox
PowerShell command syntax
1 | Set-FocusedInbox -Identity <Mailbox> -FocusedInboxOn $False |
PowerShell command Example
1 | Set-FocusedInbox -Identity Bob -FocusedInboxOn $False |
Disable Focused Inbox | All Exchange USER Mailboxes (Bulk)
PowerShell command Example
1 | Get-MailBox -Filter '(RecipientTypeDetails -eq "UserMailbox")' | Set-FocusedInbox -FocusedInboxOn $False |
Export + View (Display) “Focused Inbox” settings” option
View Focused Inbox settings | Organization level
PowerShell command Example
1 | Get-OrganizationConfig | Select *FocusedInbox* |
View Focused Inbox settings | Single Mailbox
PowerShell command syntax
1 | Get-FocusedInbox -Identity <Mailbox> |
PowerShell command Example
1 | Get-FocusedInbox -Identity Bob |Select MailboxIdentity, FocusedInboxOn ,FocusedInboxOnLastUpdateTime |
View (Display) information about All Exchange user mailboxes Focused Inbox (Enabled or Disabled)
PowerShell command Example
1 | Get-MailBox -Filter '(RecipientTypeDetails -eq "UserMailbox")' | Get-FocusedInbox | Select MailboxIdentity, FocusedInboxOn ,FocusedInboxOnLastUpdateTime |
View (Display) information about All Exchange user mailboxes that their Focused Inbox option is Enabled
PowerShell command Example
1 | Get-Mailbox | Where {$_.RecipientTypeDetails -eq 'UserMailbox'}| Get-FocusedInbox | Where {$_.FocusedInboxOn -eq ‘$True’} | Select MailboxIdentity, FocusedInboxOn ,FocusedInboxOnLastUpdateTime |
View (Display) information about All Exchange user mailboxes that their Focused Inbox option is Disabled
PowerShell command Example
1 | Get-Mailbox | Where {$_.RecipientTypeDetails -eq 'UserMailbox'}| Get-FocusedInbox | Where {$_.FocusedInboxOn -eq $False} | Select MailboxIdentity, FocusedInboxOn ,FocusedInboxOnLastUpdateTime |
Export information about All Exchange user mailboxes Focused Inbox (Enabled or Disabled)
PowerShell command Example
1 | Get-MailBox -Filter '(RecipientTypeDetails -eq "UserMailbox")' | Get-FocusedInbox | Select MailboxIdentity, FocusedInboxOn ,FocusedInboxOnLastUpdateTime | Export-CSVc:\temp\"All Exchange user mailboxes that their Focused Inbox option is Enabled.CSV" –NoTypeInformation -Encoding utf8 |
SECTION D: Using Exchange Online rule to send specific E-mails Focused Inbox
When using the Focused Inbox 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 Focused Inbox view.
In some scenarios, the Focused Inbox algorithm, can decide not to classify E-mail messages as an E-mail that will be sent to the Focused Inbox view. In other words, the Focused Inbox algorithm, can decide that specific E-mail address is not important, and this E-mail will not “sent” to the Focused Inbox view.
To be able to override this decision and to be able to “inform” Exchange server that we would like to send a specific E-mail to the Focused view.
The Exchange rule is implemented by, defining the characters of these specific emails, and asks from Exchange to add a specific mail field to the E-mail message header.
This special mail field is named – X-MS-Exchange-Organization-BypassFocusedInbox.
We will need to add this mail field, and set the value of this mail field to “true”
For example
X-MS-Exchange-Organization-BypassFocusedInbox = true
In case that Exchange server “locate” this mail field, he “understands” that he needs to bypass the Focused Inbox 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 Focused Inbox process for specific mail items.
Create an Exchange rule that bypasses the Focused Inbox process for E-mail that includes a specific text in the mail SUBJECT
PowerShell command syntax
1 | New-TransportRule -Name <Name of the rule> -SubjectContainsWords "<Text String>" -SetHeaderName " X-MS-Exchange-Organization-BypassFocusedInbox" -SetHeaderValue "true" |
PowerShell command Example
1 | New-TransportRule -Name “Bypass Clutter – Subject important” -SubjectContainsWords "important" -SetHeaderName " X-MS-Exchange-Organization-BypassFocusedInbox" -SetHeaderValue "true" |
Create an Exchange rule that will bypass Focused Inbox process for E-mail that sent from a specific SENDER
PowerShell command syntax
1 | New-TransportRule -Name <Name of the rule> -From "<E-mail address>" -SetHeaderName " X-MS-Exchange-Organization-BypassFocusedInbox" -SetHeaderValue "true" |
PowerShell command Example
1 2 | New-TransportRule -Name “Bypass Clutter – E-mail from Bob” -From Bob@o365info.com -SetHeaderName " X-MS-Exchange-Organization-BypassFocusedInbox" -SetHeaderValue "true" |
Additional reading
PowerShell -Focused Inbox
General information -Focused Inbox
- How the Focused Inbox Replaces Clutter Inside Office 365
- Managing Focused Inbox in Office 365 and Outlook
- Focused Inbox for Outlook
Enable or Disable Focused Inbox Outlook \OWA
Enable or Disable Focused Inbox Using Exchange Online transport rule
Video links – Focused Inbox
Getting started with Office 365 PowerShell
Get more information about the Naming Conventions that are used in the PowerShell articles – Help and additional information – o365info.com PowerShell articles
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
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
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.
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
It is important for us to know your opinion on this article
PowerShell command syntax – Office 365 | Article series index
