Configure Microsoft 365 Group Expiration Policy Using Entra Admin Center & Microsoft Graph PowerShell (Get-MgGroupLifecyclePolicy)

With the rapid growth of Microsoft Teams and Microsoft 365 Groups (Unified Groups) across enterprise tenants, sprawl quickly becomes a governance headache. Configuring a Microsoft 365 Group Expiration Policy (Group Lifecycle Policy) automatically cleans up abandoned groups and teams while keeping active workspaces untouched.

In this updated 2026 Governance Runbook, we show how activity-based auto-renewal works, how to configure expiration in the Microsoft Entra Admin Center, and how to automate lifecycle policies using the Microsoft Graph PowerShell SDK (Get-MgGroupLifecyclePolicy, New-MgGroupLifecyclePolicy, and Update-MgGroupLifecyclePolicy, replacing the retired AzureADPreview cmdlets).


Architecture: How Microsoft 365 Group Activity Auto-Renewal & Expiration Works

Microsoft 365 Group & Teams Lifecycle Expiration Workflow
Active Groups
Silent Auto-Renewal
  • SharePoint: View, edit, download, or upload files
  • Outlook: Join group or read/receive group message
  • Teams: Visit a standard or shared channel
Inactive Groups
30 / 15 / 1-Day Warnings
  • Emails sent to Group Owners (30, 15, and 1 day prior)
  • Ownerless groups route to alternateNotificationEmails
  • One-click renewal extends lifetime by N days
Unrenewed Expiration
30-Day Soft Delete
  • Group, Team, Planner, & SharePoint site soft-deleted
  • Recoverable for 30 days via Restore-MgDirectoryDeletedItem
  • Permanently purged after 30 days

Which User Actions Automatically Renew a Microsoft 365 Group?

You don't need to worry about active project teams receiving annoying expiration emails. Microsoft Entra ID tracks daily user activity across connected workloads and automatically renews the group if any of the following actions occur before expiration:

WorkloadActivity That Triggers Automatic Group Renewal
Microsoft TeamsAny user views or visits a channel in the Team
SharePoint OnlineAny user views, edits, downloads, moves, shares, or uploads a file in the group's SharePoint site
Exchange Online (Outlook)Any user joins the group, or reads/writes a message in the group mailbox from Outlook or OWA
Viva Engage (Yammer)Any user views a post within the Viva Engage community
Microsoft FormsAny user views, creates, or submits a response to a Group Form

Step 1: Audit Your Current Group Expiration Policy via Microsoft Graph PowerShell

The legacy Get-AzureADMSGroupLifecyclePolicy cmdlet is retired. Use Get-MgGroupLifecyclePolicy (or Invoke-MgGraphRequest against /v1.0/groupLifecyclePolicies) to inspect your tenant's current expiration configuration and list groups approaching expiration:

POWERSHELL
# Connect to Microsoft Graph using Certificate-Based App-Only Auth
Connect-MgGraph `
    -ClientId "c841ae33-4093-4385-8a90-6a530761f9b9" `
    -TenantId "ab85c7a1-366d-44ba-acc6-924fa0950045" `
    -CertificateThumbprint "BEAC429DE404B46FF030811C0C9DE00DE701C027" `
    -NoWelcome

# 1. Inspect the active Group Lifecycle Policy in the tenant
Write-Host "=== Active Group Lifecycle Policy ===" -ForegroundColor Cyan
Get-MgGroupLifecyclePolicy |
    Select-Object Id, GroupLifetimeInDays, ManagedGroupTypes, AlternateNotificationEmails | Format-List

# 2. Audit Microsoft 365 Unified Groups and their Expiration & Last Renewed timestamps
Write-Host "=== Microsoft 365 Unified Groups Expiration Status ===" -ForegroundColor Cyan
Get-MgGroup -Filter "groupTypes/any(c:c eq 'Unified')" -All `
    -Property Id, DisplayName, Mail, CreatedDateTime, ExpirationDateTime, RenewedDateTime |
    Select-Object DisplayName, Mail, CreatedDateTime, ExpirationDateTime, RenewedDateTime |
    Format-Table -AutoSize

Live Output from Our LAB 365 (xzf58.onmicrosoft.com) Tenant:

TEXT
=== Active Group Lifecycle Policy ===
Id                          : 1414c30e-4137-4306-913e-80ef1779ab35
GroupLifetimeInDays         : 30
ManagedGroupTypes           : All
AlternateNotificationEmails : [email protected];[email protected]

=== Microsoft 365 Unified Groups Expiration Status ===
DisplayName       Mail                                   CreatedDateTime       ExpirationDateTime RenewedDateTime
-----------       ----                                   ---------------       ------------------ ---------------
Compliance Admins [email protected] 4/5/2023 10:37:41 AM                     4/5/2023 10:37:41 AM

Step 2: Create or Update the Group Expiration Policy (New-MgGroupLifecyclePolicy / Update-MgGroupLifecyclePolicy)

A Microsoft Entra tenant can have at most one groupLifecyclePolicy object. Its ManagedGroupTypes property accepts one of three values:

  • All: Applies expiration to every Microsoft 365 Group in the tenant.
  • Selected: Applies expiration only to specific Microsoft 365 Groups added via Add-MgGroupToLifecyclePolicy (up to 500 groups—ideal for a phased rollout or pilot!).
  • None: Disables group expiration across the tenant.
POWERSHELL
# Check if a Group Lifecycle Policy already exists
$ExistingPolicy = Get-MgGroupLifecyclePolicy

$PolicyParams = @{
    GroupLifetimeInDays         = 180   # Expire inactive groups after 180 days
    ManagedGroupTypes           = "Selected" # 'All', 'Selected', or 'None'
    AlternateNotificationEmails = "[email protected];[email protected]"
}

if ($ExistingPolicy) {
    Write-Host "[+] Updating existing Group Lifecycle Policy ($($ExistingPolicy.Id))..." -ForegroundColor Cyan
    Update-MgGroupLifecyclePolicy -GroupLifecyclePolicyId $ExistingPolicy.Id -BodyParameter $PolicyParams
} else {
    Write-Host "[+] Creating new Group Lifecycle Policy..." -ForegroundColor Green
    $ExistingPolicy = New-MgGroupLifecyclePolicy -BodyParameter $PolicyParams
}

Scoping Expiration to Specific Groups (ManagedGroupTypes = "Selected")

When ManagedGroupTypes is set to "Selected", use Add-MgGroupToLifecyclePolicy to enroll specific Microsoft 365 Groups into the policy:
POWERSHELL
$TargetGroup = Get-MgGroup -Filter "mail eq '[email protected]'"

Add-MgGroupToLifecyclePolicy `
    -GroupLifecyclePolicyId $ExistingPolicy.Id `
    -BodyParameter @{ groupId = $TargetGroup.Id }

Step 3: Configure Group Expiration in the Microsoft Entra Admin Center (GUI)

If you prefer configuring the policy through the portal:

  1. Sign in to the Microsoft Entra admin center (https://entra.microsoft.com) as at least a Groups Administrator.
  2. Navigate to Identity -> Groups -> All groups -> Expiration.
  3. Configure:

- Group lifetime (in days): Choose 180, 365, or a Custom value (minimum 30 days). - Email contact for groups with no owners: Enter a monitored shared mailbox or admin DL (e.g., [email protected]) so ownerless groups don't expire without notice. - Enable expiration for these Microsoft 365 groups: Select All, Selected (recommended for initial rollout), or None, and click Save.