Set-EntraGroupLifecyclePolicy

Módulo:
Microsoft.Entra.Groups Module v1.3

Actualiza una directiva de ciclo de vida de grupo específica en Microsoft Entra ID.

Sintaxis

Default (valor predeterminado) 

Set-EntraGroupLifecyclePolicy

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

Description

El Set-EntraGroupLifecyclePolicy comando actualiza una directiva de ciclo de vida de grupo específica en Microsoft Entra ID.

Ejemplos

Ejemplo 1: Actualización de la directiva de ciclo de vida del grupo

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

En este ejemplo se actualiza el groupLifecyclePolicy especificado en Microsoft Entra ID.

  • -GroupLifecyclePolicyId el parámetro especifica el identificador de la directiva de ciclo de vida que se va a modificar.
  • -GroupLifetimeInDays el parámetro especifica la duración de los grupos de la directiva en 200 días. GroupLifetimeInDays representa el número de días antes de que un grupo expire y debe renovarse. Una vez renovado, la expiración del grupo se extiende por el número de días definidos.
  • -AlternateNotificationEmails el parámetro especifica la dirección de correo electrónico que recibe notificaciones sobre la directiva. Se pueden definir varias direcciones de correo electrónico separando la dirección de correo electrónico con un punto y coma.
  • -ManagedGroupTypesel parámetro especifica a qué Microsoft 365 agrupa la directiva. Los valores posibles son All, Selected o None. En este caso, "All" sugiere que la directiva administra todos los tipos de grupos.

Parámetros

-AlternateNotificationEmails

Los correos electrónicos de notificación para grupos que no tienen propietarios se envían a estas direcciones de correo electrónico. Lista de direcciones de correo electrónico separadas por ";".

Propiedades de parámetro

Tipo:System.String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-GroupLifecyclePolicyId

Especifica el identificador de un objeto groupLifecyclePolicies en Microsoft Entra ID.

Propiedades de parámetro

Tipo:System.String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:Id

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-GroupLifetimeInDays

El número de días que puede existir un grupo antes de que tenga que renovarse.

Propiedades de parámetro

Tipo:System.Int32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ManagedGroupTypes

Permite al administrador seleccionar a qué Microsoft 365 se aplica la directiva.

  • "None" creará la directiva en un estado deshabilitado.
  • "All" aplicará la directiva a todos los Microsoft 365 grupo del inquilino.
  • "Seleccionado" permitirá al administrador elegir grupos de Microsoft 365 específicos a los que se aplica la directiva.

Propiedades de parámetro

Tipo:System.String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

System.String

Salidas

System.Object