Get-MgUserOutlookMasterCategory

What is Get-MgUserOutlookMasterCategory?

The Get-MgUserOutlookMasterCategory cmdlet retrieves a list of Outlook categories defined in a user’s mailbox. These categories are color-coded labels that help organize emails, calendar events, and tasks in Microsoft Outlook and across Microsoft 365.

Why Use Get-MgUserOutlookMasterCategory?

This cmdlet helps administrators and users manage and audit Outlook categories across mailboxes. It’s especially useful for:

• Reporting on category usage within user mailboxes.
• Synchronizing category data between Outlook and other Microsoft 365 services.
• Automating configuration tasks, such as ensuring category consistency across departments.

By integrating this cmdlet into scripts, admins can monitor or export category configurations for compliance or user experience optimization.

Prerequisites

Before running this cmdlet, install the Microsoft Graph PowerShell module and connect to Microsoft Graph with the required permissions:

Install-Module Microsoft.Graph -Scope CurrentUser
Connect-MgGraph -Scopes "MailboxSettings.Read" 

How to Use Get-MgUserOutlookMasterCategory?

Use the -UserId parameter to specify the mailbox from which to retrieve Outlook categories.

Get-MgUserOutlookMasterCategory -UserId <String>

This cmdlet can also be used in combination with other Outlook-related Graph cmdlets to analyze category usage or maintain consistency across users.

Get-MgUserOutlookMasterCategory Examples

• Example 1: Retrieve All Categories for a User

This command retrieves all Outlook categories configured for the specified user.

Get-MgUserOutlookMasterCategory -UserId "user@domain.com"

• Example 2: Retrieve Specific Category by ID

To retrieve details of a particular category, provide both the UserId and CategoryId.

Get-MgUserOutlookMasterCategory -UserId "user@domain.com" -CategoryId "categoryId"

Summary

Key Point	Details
Cmdlet Name	Get-MgUserOutlookMasterCategory
Purpose	Retrieves Outlook category details for a user’s mailbox
Required Scope	MailboxSettings.Read
Primary Parameter	UserId, CategoryId
Automation Benefit	Enables bulk reporting and category audits across users
Use Case	Maintaining category uniformity and analyzing mailbox configurations