ownerless_group_policy
Creates, updates, deletes, gets or lists an ownerless_group_policy resource.
Overview
| Name | ownerless_group_policy |
| Type | Resource |
| Id | entra_id.policies.ownerless_group_policy |
Fields
The following fields are returned by SELECT queries:
- get
Retrieved navigation property
| Name | Datatype | Description |
|---|---|---|
id | string | The unique identifier for an entity. Read-only. |
emailInfo | object | (title: emailDetails) |
enabledGroupIds | array | The collection of IDs for groups to which the policy is enabled. If empty, the policy is enabled for all groups in the tenant. |
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 | number (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 | number (int64) | The number of weeks for the notification duration. Value range is 1-7. |
policyWebUrl | string | The URL to the policy documentation. |
targetOwners | object | (title: targetOwners) |
Methods
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
get | select | Read the properties of an ownerlessGroupPolicy object. | ||
update | update | Create or update the ownerlessGroupPolicy for the tenant. If the policy doesn't exist, it creates a new one; if the policy exists, it updates the existing policy. To disable the policy, set isEnabled to false. Setting isEnabled to false clears the values of all other policy parameters. |
Parameters
Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.
| Name | Datatype | Description |
|---|
SELECT examples
- get
Read the properties of an ownerlessGroupPolicy object.
SELECT
id,
emailInfo,
enabledGroupIds,
isEnabled,
maxMembersToNotify,
notificationDurationInWeeks,
policyWebUrl,
targetOwners
FROM entra_id.policies.ownerless_group_policy
;
UPDATE examples
- update
Create or update the ownerlessGroupPolicy for the tenant. If the policy doesn't exist, it creates a new one; if the policy exists, it updates the existing policy. To disable the policy, set isEnabled to false. Setting isEnabled to false clears the values of all other policy parameters.
UPDATE entra_id.policies.ownerless_group_policy
SET
id = '{{ id }}',
emailInfo = '{{ emailInfo }}',
enabledGroupIds = '{{ enabledGroupIds }}',
isEnabled = {{ isEnabled }},
maxMembersToNotify = {{ maxMembersToNotify }},
notificationDurationInWeeks = {{ notificationDurationInWeeks }},
policyWebUrl = '{{ policyWebUrl }}',
targetOwners = '{{ targetOwners }}'
RETURNING
id,
emailInfo,
enabledGroupIds,
isEnabled,
maxMembersToNotify,
notificationDurationInWeeks,
policyWebUrl,
targetOwners;