Get-EntraGroupMember

Get-EntraGroupMember

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

Il Get-EntraGroupMember cmdlet ottiene un membro di un gruppo in Microsoft Entra ID. Specificare il GroupId parametro per ottenere un membro di un gruppo.

Negli scenari delegati, l'utente connesso deve avere un ruolo Microsoft Entra supportato o un ruolo personalizzato con una delle autorizzazioni seguenti: microsoft.directory/groups/members/read, microsoft.directory/groups/members/limitedReado microsoft.directory/groups/hiddenMembers/read (per i membri nascosti). I ruoli con privilegi minimi seguenti supportano questa operazione:

• Proprietari del gruppo
• Utenti "Membro"
• Utenti "Guest" (con autorizzazioni di lettura limitate)
• Amministratori che leggono la directory
• Scrittori della Directory
• Amministratore di gruppi
• Amministratore utenti (include membri nascosti)
• amministratore Exchange (include membri nascosti)
• amministratore SharePoint (include membri nascosti)
• Amministratore di Intune (include membri nascosti)
• Amministratore di Teams (include membri nascosti)
• amministratore Viva Engage (include membri nascosti)

Per elencare i membri di un gruppo nascosto, è necessaria anche l'autorizzazione 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

In questo esempio vengono recuperati i membri di un gruppo specificato in base al relativo GroupId oggetto e vengono selezionate solo le Idproprietà e DisplayName@odata.type per ogni membro.

• -GroupId specifica l'ID di un gruppo.

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

In questo esempio viene illustrato come recuperare i primi due gruppi da Microsoft Entra ID. È possibile usare -Limit come alias per -Top.

• -GroupId specifica l'ID di un gruppo.

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

In questo esempio vengono recuperati tutti i membri all'interno di un gruppo in base all'ID gruppo.

• -GroupId specifica l'ID di un gruppo.

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

In questo esempio viene illustrato come recuperare il membro del gruppo in base all'ID.

• -GroupId Specifica l'ID di un gruppo.

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.