Set-EntraGroupLifecyclePolicy

更新Microsoft Entra ID中的特定组生命周期策略。

语法

Default (默认值)

Set-EntraGroupLifecyclePolicy

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

说明

Set-EntraGroupLifecyclePolicy命令更新Microsoft Entra ID中的特定组生命周期策略。

示例

示例 1:更新组生命周期策略

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

此示例在 Microsoft Entra ID 中更新指定的 groupLifecyclePolicy。

  • -GroupLifecyclePolicyId 参数指定要修改的生命周期策略的 ID。
  • -GroupLifetimeInDays 参数指定策略中组的生存期为 200 天。 GroupLifetimeInDays 表示组过期前的天数,需要续订。 续订后,组过期时间将延长为定义的天数。
  • -AlternateNotificationEmails 参数指定接收有关策略通知的电子邮件地址。 可以通过用分号分隔电子邮件地址来定义多个电子邮件地址。
  • -ManagedGroupTypes参数指定策略适用的Microsoft 365组。 可能的值为 AllSelectedNone。 在这种情况下,“All”建议策略管理所有类型的组。

参数

-AlternateNotificationEmails

没有所有者的组的通知电子邮件将发送到这些电子邮件地址。 用“;”分隔的电子邮件地址列表。

参数属性

类型:System.String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-GroupLifecyclePolicyId

指定 Microsoft Entra ID 中的 groupLifecyclePolicies 对象的 ID。

参数属性

类型:System.String
默认值:None
支持通配符:False
不显示:False
别名:Id

参数集

(All)
Position:Named
必需:True
来自管道的值:True
来自管道的值(按属性名称):True
来自剩余参数的值:False

-GroupLifetimeInDays

组在需要续订之前可以存在的天数。

参数属性

类型:System.Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ManagedGroupTypes

允许管理员选择策略适用的Microsoft 365组。

  • “无”将创建处于禁用状态的策略。
  • “全部”会将策略应用于租户中的每个Microsoft 365组。
  • “已选择”将允许管理员选择策略适用的特定Microsoft 365组。

参数属性

类型:System.String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters

输入

System.String

输出

System.Object