Set-EntraGroupLifecyclePolicy

Set-EntraGroupLifecyclePolicy

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

Set-EntraGroupLifecyclePolicy コマンドは、Microsoft Entra IDの特定のグループ ライフサイクル ポリシーを更新します。

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

次の使用例は、指定した groupLifecyclePolicy を Microsoft Entra ID で更新します。

• -GroupLifecyclePolicyId パラメーターは、変更するライフサイクル ポリシーの ID を指定します。
• -GroupLifetimeInDays パラメーターは、ポリシー内のグループの有効期間を 200 日に指定します。 GroupLifetimeInDays は、グループの有効期限が切れるまでの日数を表し、更新する必要があります。 更新されると、グループの有効期限は定義された日数だけ延長されます。
• -AlternateNotificationEmails パラメーターは、ポリシーに関する通知を受信する電子メール アドレスを指定します。 複数のメール アドレスを定義するには、メール アドレスをセミコロンで区切ります。
• -ManagedGroupTypesパラメーターは、ポリシーを適用するMicrosoft 365グループを指定します。 設定可能な値は、All、Selected、または None です。 この場合、[すべて] は、ポリシーがすべての種類のグループを管理することを提案します。

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。