New-AzureADMSGroupLifecyclePolicy

Module:

AzureAD Module

Creates a new groupLifecyclePolicy

Syntax

Default (Default)

New-AzureADMSGroupLifecyclePolicy
    -GroupLifetimeInDays <Int32>
    -ManagedGroupTypes <String>
    -AlternateNotificationEmails <String>
    [<CommonParameters>]

Description

Creates a new groupLifecyclePolicy in Azure Active Directory

Examples

Example 1

PS C:\> New-AzureADMSGroupLifecyclePolicy -GroupLifetimeInDays 99 -ManagedGroupTypes "Selected" -AlternateNotificationEmails "example@contoso.com"

This will create a a new groupLifecyclePolicy setting the group lifetime to 99 days for a selected set of Office 365 groups and send renewal notification emails to groups that have no owners to "example@contoso.com"

Parameters

-AlternateNotificationEmails

Notification emails for groups that have no owners will be sent to these email addresses. List of email addresses separated by a ";".

Parameter properties

Type:	String
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

(All)

Position:	Named
Mandatory:	True
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-GroupLifetimeInDays

The number of days a group can exist before it needs to be renewed

Parameter properties

Type:	Int32
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

(All)

Position:	Named
Mandatory:	True
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-ManagedGroupTypes

This parameter allows the admin to select which office 365 groups the policy will apply to. "None" will create the policy in a disabled state. "All" will apply the policy to every Office 365 group in the tenant. "Selected" will allow the admin to choose specific Office 365 groups that the policy will apply to.

Parameter properties

Type:	String
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

(All)

Position:	Named
Mandatory:	True
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs

None

Outputs

Object

Notes

See the migration guide for New-AzureADMSGroupLifecyclePolicy to the Microsoft Graph PowerShell.