Skip to content

ownerlessgrouppolicy.md

Latest commit

 

History

History
68 lines (58 loc) · 3.08 KB

ownerlessgrouppolicy.md

File metadata and controls

68 lines (58 loc) · 3.08 KB
title ownerlessGroupPolicy resource type
description Represents the configuration for managing M365 groups that have lost their sole owner.
author Ananya-Sharma
ms.date 02/12/2026
ms.localizationpriority medium
ms.subservice exchange
doc_type resourcePageType

ownerlessGroupPolicy resource type

Namespace: microsoft.graph

[!INCLUDE beta-disclaimer]

Represents the configuration for managing Microsoft 365 groups that have lost their sole owner. Use this policy to send actionable notification emails to active members of ownerless groups to accept ownership. Administrators can configure notification duration, maximum members to notify, and control ownership eligibility by using security groups.

For more information, see Manage ownerless Microsoft 365 groups and teams

Inherits from entity.

Methods

Method Return type Description
Get ownerlessGroupPolicy Read the properties of an ownerlessGroupPolicy object.
Upsert ownerlessGroupPolicy Create or update an ownerlessGroupPolicy object.

Properties

Property Type Description
emailInfo emailDetails The email notification details for the ownerless group policy, including the sender, subject, and body.
enabledGroupIds String collection The collection of IDs for groups to which the policy is enabled.
isEnabled Boolean Indicates whether the ownerless group policy is enabled in the tenant. Setting this property to false clears the values of all other policy parameters.
maxMembersToNotify Int64 The maximum number of members to notify. Value range is 0-90. Members are prioritized by recent group activity (most active first). If there aren't enough active members to fill the limit, remaining slots are filled with other eligible group members from the directory.
notificationDurationInWeeks Int64 The number of weeks for the notification duration. Value range is 1-7.
policyWebUrl String The URL to the policy documentation.
targetOwners targetOwners The criteria for selecting target owners for the ownerless group.

Relationships

None.

JSON representation

The following JSON representation shows the resource type.

{
  "@odata.type": "#microsoft.graph.ownerlessGroupPolicy",
  "isEnabled": "Boolean",
  "notificationDurationInWeeks": "Integer",
  "maxMembersToNotify": "Integer",
  "enabledGroupIds": [
    "String"
  ],
  "emailInfo": {
    "@odata.type": "microsoft.graph.emailDetails"
  },
  "policyWebUrl": "String",
  "targetOwners": {
    "@odata.type": "microsoft.graph.targetOwners"
  }
}