Get-PnPMicrosoft365ExpiringGroup
SYNOPSIS
Required Permissions
- Microsoft Graph API : One of Directory.Read.All, Directory.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, GroupMember.Read.All, GroupMember.ReadWrite.All
Gets all soon to expire Microsoft 365 Groups.
SYNTAX
Get-PnPMicrosoft365ExpiringGroup [-Limit <Int32>] [-Connection <PnPConnection>]
DESCRIPTION
This command returns all soon to expire Microsoft 365 Groups. By default, groups expiring in the next 31 days are returned (in accordance with SharePoint/OneDrive's retention period's 31-day months). The -Limit parameter can be used to specify a different time period.
EXAMPLES
EXAMPLE 1
Get-PnPMicrosoft365ExpiringGroup
Returns all Groups expiring within 31 days (roughly 1 month).
EXAMPLE 2
Get-PnPMicrosoft365ExpiringGroup -Limit 93
Returns all Microsoft 365 Groups expiring in 93 days (roughly 3 months)
PARAMETERS
-Limit
Limits Groups to be returned to Groups expiring in as many days.
Type: Int32
Parameter Sets: (All)
Required: False
Position: Named
Default value: 31
Accept pipeline input: False
Accept wildcard characters: False
-Connection
Optional connection to be used by the cmdlet. Retrieve the value for this parameter by either specifying -ReturnConnection on Connect-PnPOnline or by executing Get-PnPConnection.
Type: PnPConnection
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False