Set-EntraGroupLifecyclePolicy

Met à jour une politique de cycle de vie de groupe spécifique dans Microsoft Entra ID.

Syntaxe

Default (Par défaut)

Set-EntraGroupLifecyclePolicy

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

Description

La Set-EntraGroupLifecyclePolicy commande met à jour une stratégie de cycle de vie de groupe spécifique dans Microsoft Entra ID.

Exemples

Exemple 1 : Mettre à jour la stratégie de cycle de vie du groupe

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

Cet exemple met à jour groupLifecyclePolicy spécifié dans Microsoft Entra ID.

  • -GroupLifecyclePolicyId spécifie l’ID de la stratégie de cycle de vie à modifier.
  • -GroupLifetimeInDays spécifie la durée de vie des groupes dans la stratégie à 200 jours. GroupLifetimeInDays représente le nombre de jours avant l’expiration d’un groupe et doit être renouvelé. Une fois renouvelé, l’expiration du groupe est étendue par le nombre de jours définis.
  • -AlternateNotificationEmails spécifie l’adresse e-mail qui reçoit des notifications sur la stratégie. Plusieurs adresses e-mail peuvent être définies en séparant l’adresse e-mail par un point-virgule.
  • -ManagedGroupTypesspécifie les Microsoft 365 groupes auxquels la stratégie s’applique. Les valeurs possibles sont All, Selected ou None. Dans ce cas, « All » suggère que la stratégie gère tous les types de groupes.

Paramètres

-AlternateNotificationEmails

Les e-mails de notification pour les groupes qui n’ont pas de propriétaire sont envoyés à ces adresses e-mail. Liste des adresses e-mail séparées par un « ; ».

Propriétés du paramètre

Type:System.String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-GroupLifecyclePolicyId

Spécifie l’ID d’un objet groupLifecyclePolicies dans Microsoft Entra ID.

Propriétés du paramètre

Type:System.String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Id

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-GroupLifetimeInDays

Nombre de jours pendant lesquels un groupe peut exister avant de devoir être renouvelé.

Propriétés du paramètre

Type:System.Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ManagedGroupTypes

Permet à l’administrateur de sélectionner les Microsoft 365 groupes auxquels la stratégie s’applique.

  • « Aucun » crée la stratégie dans un état désactivé.
  • « Tout » applique la stratégie à chaque groupe de Microsoft 365 dans le locataire.
  • « Sélectionné » permet à l’administrateur de choisir des groupes Microsoft 365 spécifiques auxquels la stratégie s’applique.

Propriétés du paramètre

Type:System.String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

System.String

Sorties

System.Object