Get-MgmtGraphGroupLifecyclePolicy

MgmtGraph: Retrieves group lifecycle policies

Script

#Requires -Version 5.1
#Requires -Modules Microsoft.Graph.Groups

[CmdletBinding(DefaultParameterSetName = 'ListAll')]
Param (
    [Parameter(Mandatory = $true, ParameterSetName = 'ByGroup', Position = 0)]
    [string]$GroupId,

    [Parameter(Mandatory = $true, ParameterSetName = 'ByPolicyId', Position = 0)]
    [string]$GroupLifecyclePolicyId
)

Process {
    try {
        $policies = $null
        $params = @{
            'ErrorAction' = 'Stop'
        }

        if ($PSCmdlet.ParameterSetName -eq 'ByGroup') {
            $params.Add('GroupId', $GroupId)
            $policies = Get-MgGroupLifecyclePolicyByGroup @params
        }
        elseif ($PSCmdlet.ParameterSetName -eq 'ByPolicyId') {
            $params.Add('GroupLifecyclePolicyId', $GroupLifecyclePolicyId)
            $policies = Get-MgGroupLifecyclePolicy @params
        }
        else {
            $params.Add('All', $true)
            $policies = Get-MgGroupLifecyclePolicy @params
        }

        $results = foreach ($p in $policies) {
            [PSCustomObject]@{
                PolicyId                     = $p.Id
                GroupLifetimeInDays          = $p.GroupLifetimeInDays
                ManagedGroupTypes            = $p.ManagedGroupTypes
                AlternateNotificationEmails = $p.AlternateNotificationEmails
                Timestamp                    = Get-Date -Format "yyyy-MM-dd HH:mm:ss"
            }
        }

        Write-Output $results
    }
    catch {
        throw
    }
}

Customize

GroupId string

The unique identifier of the Microsoft Graph group to get associated policies for.

GroupLifecyclePolicyId string

The unique identifier of the group lifecycle policy to retrieve.