Set-EntraGroupLifecyclePolicy

Modul:
Microsoft.Entra.Groups Module v1.3

Aktualisiert eine bestimmte Gruppenlebenszyklusrichtlinie in Microsoft Entra ID.

Syntax

Default (Standard) 

Set-EntraGroupLifecyclePolicy

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

Beschreibung

Der Set-EntraGroupLifecyclePolicy Befehl aktualisiert eine bestimmte Gruppenlebenszyklusrichtlinie in Microsoft Entra ID.

Beispiele

Beispiel 1: Aktualisiert die Gruppenlebenszyklusrichtlinie

Connect-Entra -Scopes 'Directory.ReadWrite.All'
$policy = Get-EntraGroupLifecyclePolicy | Where-Object {$_.AlternateNotificationEmails -eq 'example@contoso.com'}
Set-EntraGroupLifecyclePolicy -GroupLifecyclePolicyId $policy.Id -GroupLifetimeInDays 200 -AlternateNotificationEmails 'example@contoso.com' -ManagedGroupTypes 'All'

Id                                   AlternateNotificationEmails GroupLifetimeInDays ManagedGroupTypes
--                                   --------------------------- ------------------- -----------------
ffffffff-5555-6666-7777-aaaaaaaaaaaa example@contoso.com                     200                 All

In diesem Beispiel wird die angegebene groupLifecyclePolicy in Microsoft Entra ID aktualisiert.

  • -GroupLifecyclePolicyId der Parameter gibt die ID der zu ändernden Lifecycle-Richtlinie an.
  • -GroupLifetimeInDays der Parameter gibt die Lebensdauer der Gruppen in der Richtlinie auf 200 Tage an. Die GroupLifetimeInDays stellt die Anzahl der Tage dar, bevor eine Gruppe abläuft und verlängert werden muss. Nach der Verlängerung wird der Ablauf der Gruppe um die festgelegte Anzahl von Tagen verlängert.
  • -AlternateNotificationEmails der Parameter gibt die E-Mail-Adresse an, die Benachrichtigungen über die Richtlinie empfängt. Mehrere E-Mail-Adressen können durch Trennen der E-Mail-Adresse durch ein Semikolon definiert werden.
  • -ManagedGroupTypesder Parameter gibt an, für welche Microsoft 365 Gruppen die Richtlinie gilt. Mögliche Werte sind All, Selected oder None. In diesem Fall schlägt "Alle" vor, dass die Richtlinie alle Arten von Gruppen verwaltet.

Parameter

-AlternateNotificationEmails

Benachrichtigungs-E-Mails für Gruppen ohne Besitzer werden an diese E-Mail-Adressen gesendet. Liste der durch ein ";" getrennten E-Mail-Adressen.

Parametereigenschaften

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

Parametersätze

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

-GroupLifecyclePolicyId

Gibt die ID eines groupLifecyclePolicies -Objekts in Microsoft Entra ID an.

Parametereigenschaften

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

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
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:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ManagedGroupTypes

Ermöglicht dem Administrator auszuwä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.
  • "Ausgewählt" ermöglicht es dem Administrator, bestimmte Microsoft 365 Gruppen auszuwä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:False
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

System.String

Ausgaben

System.Object