Get-EntraGroupMember

Get-EntraGroupMember

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

指令檔會Get-EntraGroupMember獲得 Microsoft Entra ID 群組的成員。 指定 GroupId 參數以獲得群組成員。

在委派情境下，登入使用者必須擁有支援的 Microsoft Entra 角色或自訂角色，並具備以下其中一項權限：microsoft.directory/groups/members/read、 ，microsoft.directory/groups/members/limitedRead或microsoft.directory/groups/hiddenMembers/read（隱藏成員）。 以下最低權限角色支援此操作：

• 群組擁有者
• 「會員」使用者
• 「訪客」使用者（擁有有限的讀取權限）
• 目錄讀取者
• 目錄編輯者
• 群組管理員
• 使用者管理員（包含隱藏成員）
• Exchange 管理員（包含隱藏成員）
• SharePoint 管理員（包含隱藏成員）
• Intune 管理員（包含隱藏成員）
• Teams 管理員（包含隱藏成員）
• Viva Engage 管理員（包含隱藏成員）

若要列出隱藏群組的成員，也需要取得 Member.Read.Hidden 權限。

Connect-Entra -Scopes 'GroupMember.Read.All'
$group = Get-EntraGroup -Filter "DisplayName eq 'Sales and Marketing'"
Get-EntraGroup -GroupId $group.Id | Get-EntraGroupMember | Select-Object Id, DisplayName, '@odata.type'

Id                                   DisplayName       @odata.type
------------------------------------ ----------------- -------------------------------
dddddddd-3333-4444-5555-eeeeeeeeeeee Sawyer Miller     #microsoft.graph.user
eeeeeeee-4444-5555-6666-ffffffffffff Alex Wilber       #microsoft.graph.user
aaaaaaaa-6666-7777-8888-bbbbbbbbbbbb My Application    #microsoft.graph.servicePrincipal
cccccccc-8888-9999-0000-dddddddddddd Contoso Group     #microsoft.graph.group

此範例透過其GroupId取得指定群的成員，並僅IdDisplayName@odata.type選擇每個成員的屬性。

• -GroupId 指定一個群組的識別碼。

Connect-Entra -Scopes 'GroupMember.Read.All'
$group = Get-EntraGroup -Filter "DisplayName eq 'Sales and Marketing'"
Get-EntraGroupMember -GroupId $group.Id -Top 2 | Select-Object Id, DisplayName, '@odata.type'

Id                                   DisplayName       @odata.type
------------------------------------ ----------------- -------------------------------
dddddddd-3333-4444-5555-eeeeeeeeeeee Sawyer Miller     #microsoft.graph.user
aaaaaaaa-6666-7777-8888-bbbbbbbbbbbb My Application    #microsoft.graph.servicePrincipal

此範例示範如何從 Microsoft Entra ID 中取得前兩組。 您可以使用 -Limit 作為 -Top的別名。

• -GroupId 指定一個群組的識別碼。

Connect-Entra -Scopes 'GroupMember.Read.All'
$group = Get-EntraGroup -Filter "DisplayName eq 'Sales and Marketing'"
Get-EntraGroupMember -GroupId $group.Id -All | Select-Object Id, DisplayName, '@odata.type'

Id                                   DisplayName       @odata.type
------------------------------------ ----------------- -------------------------------
dddddddd-3333-4444-5555-eeeeeeeeeeee Sawyer Miller     #microsoft.graph.user
eeeeeeee-4444-5555-6666-ffffffffffff Alex Wilber       #microsoft.graph.user
aaaaaaaa-6666-7777-8888-bbbbbbbbbbbb My Application    #microsoft.graph.servicePrincipal
cccccccc-8888-9999-0000-dddddddddddd Contoso Group     #microsoft.graph.group

此範例依群組 ID 檢索群組內所有成員。

• -GroupId 指定一個群組的識別碼。

Connect-Entra -Scopes 'GroupMember.Read.All'
$group = Get-EntraGroup -Filter "DisplayName eq 'Sales and Marketing'"
Get-EntraGroupMember -GroupId $group.Id | Select-Object Id, DisplayName, '@odata.type'

Id                                   DisplayName       @odata.type
------------------------------------ ----------------- -------------------------------
dddddddd-3333-4444-5555-eeeeeeeeeeee Sawyer Miller     #microsoft.graph.user
eeeeeeee-4444-5555-6666-ffffffffffff Alex Wilber       #microsoft.graph.user
aaaaaaaa-6666-7777-8888-bbbbbbbbbbbb My Application    #microsoft.graph.servicePrincipal
cccccccc-8888-9999-0000-dddddddddddd Contoso Group     #microsoft.graph.group

此範例示範如何依 ID 檢索群組成員。

• -GroupId 指定群組的識別碼。

此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。