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
- SharePoint: View, edit, download, or upload files
- Outlook: Join group or read/receive group message
- Teams: Visit a standard or shared channel
- Emails sent to Group Owners (30, 15, and 1 day prior)
- Ownerless groups route to
alternateNotificationEmails - One-click renewal extends lifetime by N days
- 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:
| Workload | Activity That Triggers Automatic Group Renewal |
|---|---|
| Microsoft Teams | Any user views or visits a channel in the Team |
| SharePoint Online | Any 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 Forms | Any 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:
# 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:
=== 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 viaAdd-MgGroupToLifecyclePolicy(up to 500 groups—ideal for a phased rollout or pilot!).None: Disables group expiration across the tenant.
# 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:
$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:
- Sign in to the Microsoft Entra admin center (
https://entra.microsoft.com) as at least a Groups Administrator. - Navigate to Identity -> Groups -> All groups -> Expiration.
- 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.