Get-EntraGroupMember

Get-EntraGroupMember

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

O Get-EntraGroupMember cmdlet ganha um membro de um grupo no Microsoft Entra ID. Especifique o GroupId parâmetro para obter um membro de um grupo.

Em cenários delegados, o utilizador iniciado deve ter um papel Microsoft Entra suportado ou um papel personalizado com uma das seguintes permissões: microsoft.directory/groups/members/read, microsoft.directory/groups/members/limitedRead, ou microsoft.directory/groups/hiddenMembers/read (para membros ocultos). Os seguintes papéis de menor privilégio apoiam esta operação:

• Proprietários de grupos
• Utilizadores "membros"
• Utilizadores "convidados" (com permissões de leitura limitadas)
• Leitores de Diretório
• Escritores de Diretórios
• Administrador de Grupos
• Administrador de Utilizadores (inclui membros ocultos)
• Administrador do Exchange (inclui membros ocultos)
• SharePoint Administrator (inclui membros ocultos)
• Administrador Intune (inclui membros ocultos)
• Administrador de Equipas (inclui membros ocultos)
• Viva Engage Administrator (inclui membros ocultos)

Para listar membros de um grupo oculto, também é necessária a Member.Read.Hidden permissão.

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

Este exemplo recupera os membros de um grupo especificado por seu GroupId e seleciona apenas as Idpropriedades , DisplayName e @odata.type para cada membro.

• -GroupId especifica o ID de um grupo.

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

Este exemplo demonstra como recuperar os dois principais grupos do Microsoft Entra ID. Você pode usar -Limit como um alias para -Top.

• -GroupId especifica o ID de um grupo.

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

Este exemplo recupera todos os membros dentro de um grupo por ID de grupo.

• -GroupId especifica o ID de um grupo.

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

Este exemplo demonstra como recuperar um membro do grupo por ID.

• -GroupId Especifica o ID de um grupo.

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.