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组。 可能的值为All、Selected或None。 在这种情况下,“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。