New-EntraGroupLifecyclePolicy

Modul:
Microsoft.Entra.Groups Module v1.3

Erstellt eine neue groupLifecyclePolicy.

Syntax

Default (Standard) 

New-EntraGroupLifecyclePolicy

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

Beschreibung

Erstellt eine neue groupLifecyclePolicy in Microsoft Entra ID.

Beispiele

Beispiel 1: Erstellt eine neue groupLifecyclePolicy

Connect-Entra -Scopes 'Directory.ReadWrite.All'
New-EntraGroupLifecyclePolicy -GroupLifetimeInDays 99 -ManagedGroupTypes 'Selected' -AlternateNotificationEmails 'example@contoso.com'

Id                                   AlternateNotificationEmails GroupLifetimeInDays ManagedGroupTypes
--                                   --------------------------- ------------------- -----------------
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb example@contoso.com         99                  Selected

In diesem Beispiel wird eine neue groupLifecyclePolicy mit einer Gruppenlebensdauer von 99 Tagen für einen ausgewählten Satz von Microsoft 365 Gruppen erstellt. Verlängerungsbenachrichtigungs-E-Mails werden für Gruppen ohne Besitzer gesendet example@contoso.com .

  • -GroupLifetimeInDays der Parameter gibt die Anzahl der Tage an, die eine Gruppe vorhanden sein kann, bevor sie erneuert werden muss.
  • -ManagedGroupTypesder Administrator kann auswählen, für welche Microsoft 365 Gruppen die Richtlinie gilt.
  • -AlternateNotificationEmails Der Parameter gibt Benachrichtigungs-E-Mails für die Gruppe an.

Parameter

-AlternateNotificationEmails

Benachrichtigungs-E-Mails für Gruppen ohne Besitzer werden an diese E-Mail-Adressen gesendet, getrennt von einem ";".

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-GroupLifetimeInDays

Die Anzahl der Tage, die eine Gruppe vorhanden sein kann, bevor sie erneuert werden muss.

Parametereigenschaften

Typ:System.Int32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ManagedGroupTypes

Mit diesem Parameter kann der Administrator auswählen, für welche Microsoft 365 Gruppen die Richtlinie gilt. "None" erstellt die Richtlinie in einem deaktivierten Zustand. "Alle" wendet die Richtlinie auf jede Microsoft 365 Gruppe im Mandanten an. Mit "Ausgewählt" kann der Administrator bestimmte Microsoft 365 Gruppen auswählen, für die die Richtlinie gilt.

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

None

Ausgaben

System.Object