Set-EntraGroupLifecyclePolicy

Modulo:
Microsoft.Entra.Groups Module v1.3

Aggiorna criteri specifici relativi al ciclo di vita dei gruppi in Microsoft Entra ID.

Sintassi

Default (Impostazione predefinita) 

Set-EntraGroupLifecyclePolicy

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

Descrizione

Il Set-EntraGroupLifecyclePolicy comando aggiorna criteri specifici relativi al ciclo di vita di un gruppo in Microsoft Entra ID.

Esempio

Esempio 1: Aggiorna i criteri relativi al ciclo di vita dei gruppi

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 questo esempio viene aggiornato il groupLifecyclePolicy specificato in Microsoft Entra ID.

  • -GroupLifecyclePolicyId parametro specifica l'ID dei criteri relativi al ciclo di vita da modificare.
  • -GroupLifetimeInDays parametro specifica la durata dei gruppi nei criteri a 200 giorni. GroupLifetimeInDays rappresenta il numero di giorni prima della scadenza di un gruppo e deve essere rinnovato. Una volta rinnovato, la scadenza del gruppo viene estesa in base al numero di giorni definiti.
  • -AlternateNotificationEmails parametro specifica l'indirizzo di posta elettronica che riceve notifiche sul criterio. È possibile definire più indirizzi di posta elettronica separando l'indirizzo di posta elettronica con un punto e virgola.
  • -ManagedGroupTypesparametro consente di specificare a quali Microsoft 365 raggruppare i criteri. I valori possibili sono All, Selectedo None. In questo caso, 'All' suggerisce che il criterio gestisce tutti i tipi di gruppi.

Parametri

-AlternateNotificationEmails

I messaggi di posta elettronica di notifica per i gruppi senza proprietari vengono inviati a questi indirizzi di posta elettronica. Elenco di indirizzi di posta elettronica separati da ";".

Proprietà dei parametri

Tipo:System.String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-GroupLifecyclePolicyId

Specifica l'ID di un oggetto groupLifecyclePolicies in Microsoft Entra ID.

Proprietà dei parametri

Tipo:System.String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:id

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-GroupLifetimeInDays

Numero di giorni in cui un gruppo può esistere prima di dover essere rinnovato.

Proprietà dei parametri

Tipo:System.Int32
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ManagedGroupTypes

Consente all'amministratore di selezionare i Microsoft 365 gruppi a cui si applicano i criteri.

  • "Nessuno" creerà il criterio in uno stato disabilitato.
  • "Tutti" applicherà i criteri a ogni gruppo di Microsoft 365 nel tenant.
  • "Selezionato" consentirà all'amministratore di scegliere gruppi di Microsoft 365 specifici a cui si applicano i criteri.

Proprietà dei parametri

Tipo:System.String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

System.String

Output

System.Object