Set-EntraGroupLifecyclePolicy
更新 Microsoft Entra ID 中特定群組生命週期政策。
語法
Default (預設值)
Set-EntraGroupLifecyclePolicy
-GroupLifecyclePolicyId <String>
[-AlternateNotificationEmails <String>]
[-GroupLifetimeInDays <Int32>]
[-ManagedGroupTypes <String>]
[<CommonParameters>]
Description
此指令更新 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。 在此情況下,「全部」表示該政策管理所有類型的群組。
參數
-AlternateNotificationEmails
對於沒有擁有者的群組,通知郵件會寄送到這些電子郵件地址。 電子郵件地址列表,中間以「;」分隔。
參數屬性
| 類型: | System.String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-GroupLifecyclePolicyId
指定 Microsoft Entra ID 中群組 LifecyclePolicies 物件的 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。