Get-EntraGroupLifecyclePolicy

モジュール:
Microsoft.Entra.Groups Module v1.3

Microsoft Entra IDの groupLifecyclePolicies オブジェクトのプロパティとリレーションシップを取得します。 パラメーターを指定しない場合、このコマンドレットはすべての groupLifecyclePolicies を取得します。

構文

GetQuery (既定) 

Get-EntraGroupLifecyclePolicy

    [-Property <String[]>]
    [<CommonParameters>]

GetById 

Get-EntraGroupLifecyclePolicy

    -GroupLifecyclePolicyId <String>
    [-Property <String[]>]
    [<CommonParameters>]

説明

Get-EntraGroupLifecyclePolicy コマンドは、Microsoft Entra ID内の groupLifecyclePolicies オブジェクトのプロパティとリレーションシップを取得します。 グループ ライフサイクル ポリシーを取得するには、 -GroupLifecyclePolicyId パラメーターを指定します。 パラメーターを指定しない場合、このコマンドレットはすべての groupLifecyclePolicies を取得します。

例

例 1: すべての groupLifecyclePolicies を取得する

Connect-Entra -Scopes 'Directory.Read.All'
Get-EntraGroupLifecyclePolicy

Id                                   AlternateNotificationEmails GroupLifetimeInDays ManagedGroupTypes
--                                   --------------------------- ------------------- -----------------
eeeeeeee-4444-5555-6666-ffffffffffff example@contoso.com                     200                 Selected

この例では、Microsoft Entra ID内のすべての groupLifecyclePolicies のプロパティとリレーションシップを取得する方法を示します。

例 2: groupLifecyclePolicy のプロパティを取得する

Connect-Entra -Scopes 'Directory.Read.All'
$policy = Get-EntraGroupLifecyclePolicy | Where-Object {$_.AlternateNotificationEmails -eq 'example@contoso.com'}
Get-EntraGroupLifecyclePolicy -GroupLifecyclePolicyId $policy.Id

Id                                   AlternateNotificationEmails GroupLifetimeInDays ManagedGroupTypes
--                                   --------------------------- ------------------- -----------------
ffffffff-5555-6666-7777-aaaaaaaaaaaa example@contoso.com                     200                 Selected

このコマンドは、特定のMicrosoft グループ ライフサイクル ポリシーを取得するために使用されます。

  • -GroupLifecyclePolicyIdパラメーターは、Microsoft Entra ID内の groupLifecyclePolicies オブジェクトの ID を指定します。

パラメーター

-GroupLifecyclePolicyId

Microsoft Entra IDの groupLifecyclePolicies オブジェクトの ID を指定します。

パラメーターのプロパティ

型:System.String
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:Id

パラメーター セット

GetById
配置:Named
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-Property

返されるプロパティを指定します。

パラメーターのプロパティ

型:

System.String[]

規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:Select

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

CommonParameters

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

入力

System.String

System.Nullable'1[[System.Boolean, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

出力

System.Object