Get-EntraContactMembership

Get-EntraContactMembership

    -OrgContactId <String>
    [-All]
    [-Top <Int32>]
    [-Property <String[]>]
    [<CommonParameters>]

Get-EntraContactMembership コマンドレットは、Microsoft Entra IDの連絡先メンバーシップを取得します。

このコマンドは、特定の連絡先が属しているグループ、ロール、または管理単位を理解する必要がある管理者に役立ちます。 これは、アクセスの問題のトラブルシューティング、メンバーシップの監査、および連絡先メンバーシップが正しく構成されていることを確認するために重要な場合があります。

職場または学校アカウントを使用する委任されたシナリオでは、サインインしているユーザーは、サポートされているMicrosoft Entraロールまたは必要なアクセス許可を持つカスタム ロールを持っている必要があります。 次の最小特権ロールを使用できます。

• ディレクトリの読み手
• グローバルリーダー
• ディレクトリ製作者
• Intune 管理者
• ユーザー管理者

Connect-Entra -Scopes 'OrgContact.Read.All'
$contact = Get-EntraContact -Filter "displayName eq 'Contoso Contact'"
Get-EntraContactMembership -OrgContactId $contact.Id |
Select-Object Id, DisplayName, '@odata.type', SecurityEnabled | Format-Table -AutoSize

Id                                   displayName   @odata.type            securityEnabled
--                                   -----------   -----------            ---------------
ffffffff-5555-6666-7777-aaaaaaaaaaaa All Employees #microsoft.graph.group           False

このコマンドは、指定された連絡先のすべてのメンバーシップを取得します。

Connect-Entra -Scopes 'OrgContact.Read.All'
$contact = Get-EntraContact -Filter "displayName eq 'Contoso Contact'"
Get-EntraContactMembership -OrgContactId $contact.Id -All |
Select-Object Id, DisplayName, '@odata.type', SecurityEnabled | Format-Table -AutoSize

Id                                   displayName   @odata.type            securityEnabled
--                                   -----------   -----------            ---------------
ffffffff-5555-6666-7777-aaaaaaaaaaaa All Employees #microsoft.graph.group           False

このコマンドは、指定された連絡先のすべてのメンバーシップを取得します。

Connect-Entra -Scopes 'OrgContact.Read.All'
$contact = Get-EntraContact -Filter "displayName eq 'Contoso Contact'"
Get-EntraContactMembership -OrgContactId $contact.Id -Top 2 |
Select-Object Id, DisplayName, '@odata.type', SecurityEnabled | Format-Table -AutoSize

Id                                   displayName   @odata.type            securityEnabled
--                                   -----------   -----------            ---------------
ffffffff-5555-6666-7777-aaaaaaaaaaaa All Employees #microsoft.graph.group           False

このコマンドは、指定された連絡先の上位 2 つのメンバーシップを取得します。 -Limitのエイリアスとして-Topを使用できます。

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