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。

輸入

System.String

輸出

System.Object