Expanded scheduleEntityTheme Colors: New Options for Microsoft Entra Teamwork Integration

WHAT JUST CHANGED: Expanded scheduleEntityTheme Colors

Microsoft Entra ID (formerly Azure AD) has rolled out an update to the scheduleEntityTheme enumeration, adding 18 new color options for scheduling-related entities. This change is generally available (GA) as of June 2024 and applies to all tenants using Teams Shifts, Graph API scheduling, and related integrations.

• New colors added: darkRed, cranberry, darkOrange, bronze, peach, gold, lime, forest, lightGreen, jade, lightTeal, darkTeal, steel, skyBlue, blueGray, lavender, lilac, plum, magenta, darkBrown
• Effective: Immediate for all cloud tenants
• Rollout status: General Availability (GA)
• Impacted tenants: All Microsoft Entra ID tenants with Microsoft Teams, Teams Shifts, or Graph API scheduling integrations

Who Is Affected?

• Admins managing Teams Shifts, group schedules, or app integrations with scheduling
• Developers building custom scheduling solutions via Microsoft Graph
• Tenants using PowerShell or automation to provision schedule entities
• Organizations with custom branding or theme requirements for scheduling objects

WHAT’S NEXT ON THE ROADMAP

Microsoft is actively investing in the integration between Entra ID and Microsoft Teams, focusing on both user experience and lifecycle automation:

• Deep Scheduling API Enhancements: More granular permissions for delegated scheduling access, coming to Microsoft Graph in H2 2024.
• Unified Team/Group Lifecycle Management: Improved audit and automated cleanup, previewing Q3 2024.
• Conditional Access for Schedule Entities: Early preview announced at Microsoft Build 2024, allowing CA policies to target Teams Shifts and schedule objects.
• External Identity/Guest Integration: Scheduled guest access and external user management coming to Teams Shifts, previewing July 2024.
• PowerShell Module Consolidation: Microsoft.Graph and Microsoft.Entra modules will soon offer unified scheduling cmdlets in Q4 2024, replacing legacy AzureAD/AzureRM scheduling scripts.

WHY THIS DIRECTION IS BETTER

Expanding scheduleEntityTheme options solves several real-world admin headaches:

• Improved Visual Differentiation: Admins and users can better distinguish between groups, shifts, and schedule entities, reducing confusion.
• Branding Flexibility: Organizations can align schedule entity colors with department branding, compliance, or accessibility requirements.
• Developer Control: Custom apps integrating with Teams or scheduling APIs can leverage richer theme options, improving UX.
• Competitive Edge: Microsoft now matches and exceeds the color customizations available in competing IdP solutions (e.g., Okta, Google Workspace).
• Reduced Support Overhead: Fewer complaints about indistinguishable schedules or lack of color options in Teams Shifts.

Previously, admins were limited to a handful of colors, leading to confusion in large deployments. The expanded list directly addresses feedback from enterprise customers and frontline managers.

ADJACENT ENTRA ID CHANGES YOU NEED TO KNOW

• Teamwork API Call Throttling: New throttling limits for scheduling APIs in Graph, effective August 2024. Review and update automation scripts.
• Deprecation of AzureAD Scheduling Cmdlets: AzureAD module scheduling commands will be retired December 2024. Migrate scripts to Microsoft.Graph.
• Guest Access Lifecycle Policy: Teams Shifts now supports guest user lifecycle policies, requiring updated conditional access and provisioning reviews.
• Licensing Impact: Schedule entity theme customization requires Teams/Entra licensing at the appropriate tier (Teams Premium or Entra ID P1/P2).

WHAT TO DO: Step-by-Step Admin Actions

1. Review existing schedule entities for color assignments and update as needed to leverage new theme options.
2. Update custom apps or scripts that set scheduleEntityTheme to support new colors (validate against updated enum).
3. Communicate color changes to users and managers for improved clarity.
4. Audit schedule entity usage, color distribution, and compliance with branding policies.
5. Plan migration away from deprecated AzureAD scheduling scripts.

Production PowerShell: Audit ScheduleEntityTheme Usage

Use Microsoft.Graph to enumerate schedule entities and their theme assignments. This script supports pagination and error handling, and does NOT modify any objects.

# Requires Microsoft.Graph module
Import-Module Microsoft.Graph.Teams
Connect-MgGraph -Scopes "Group.Read.All","Schedule.Read.All"

function Get-ScheduleEntityThemes {
    $allSchedules = @()
    $uri = "https://graph.microsoft.com/v1.0/teams/{teamId}/schedule"
    $teams = Get-MgTeam -PageSize 50
    foreach ($team in $teams) {
        try {
            $schedule = Invoke-MgGraphRequest -Method GET -Uri ($uri -replace "{teamId}",$team.Id)
            if ($schedule.scheduleEntities) {
                foreach ($entity in $schedule.scheduleEntities) {
                    $theme = $entity.theme
                    $allSchedules += [PSCustomObject]@{
                        TeamName = $team.DisplayName
                        EntityId = $entity.id
                        Theme = $theme
                    }
                }
            }
        } catch {
            Write-Warning "Failed to fetch schedule for team $($team.DisplayName): $($_.Exception.Message)"
        }
    }
    return $allSchedules
}

# Report with error handling and pagination
$scheduleThemes = Get-ScheduleEntityThemes
$scheduleThemes | Format-Table -AutoSize

Portal Path: Where to Find and Verify

• Go to Microsoft Entra admin center (entra.microsoft.com).
• Navigate to Identity → Groups → Teams.
• Select a Team → Scheduling → Schedule Entities → Theme.
• Admins can set or review theme color for each entity.
• For API/developer review, reference Microsoft Graph Explorer or custom app integrations.

BOTTOM LINE: Prioritised Recommendation

• Priority 1: Audit and update schedule entity themes for clarity and branding compliance.
• Priority 2: Update scripts and custom apps to support expanded color options.
• Priority 3: Prepare for upcoming scheduling API throttling and AzureAD cmdlet retirement.
• Priority 4: Communicate changes to stakeholders and end users.

Expanded scheduleEntityTheme options offer better control, improved user experience, and a more modern admin workflow. Act now to leverage new colors and stay ahead of roadmap changes in Entra, Teams, and the Microsoft Graph API.