Get-EntraGroupMember

Hämtar en medlem i en grupp.

Syntax

Default (Standard)

Get-EntraGroupMember

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

Description

Cmdleten Get-EntraGroupMember hämtar en medlem i en grupp i Microsoft Entra ID. Ange parametern GroupId för att hämta en medlem i en grupp.

I delegerade scenarier måste den inloggade användaren ha en Microsoft Entra roll som stöds eller en anpassad roll med någon av följande behörigheter: microsoft.directory/groups/members/read, microsoft.directory/groups/members/limitedReadeller microsoft.directory/groups/hiddenMembers/read (för dolda medlemmar). Följande minst privilegierade roller stöder den här åtgärden:

  • Gruppägare
  • "Medlemsanvändare"
  • Gästanvändare (med begränsad läsbehörighet)
  • Katalogläsare
  • Katalogförfattare
  • Gruppadministratör
  • Användaradministratör (inkluderar dolda medlemmar)
  • Exchange-administratör (inkluderar dolda medlemmar)
  • SharePoint-administratör (inkluderar dolda medlemmar)
  • Intune-administratör (inkluderar dolda medlemmar)
  • Teams-administratör (inkluderar dolda medlemmar)
  • Viva Engage Administratör (innehåller dolda medlemmar)

Om du vill visa en lista över medlemmar i en dold grupp krävs även behörigheten Member.Read.Hidden .

Exempel

Exempel 1: Hämta och välj egenskaper för gruppmedlem

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

Det här exemplet hämtar medlemmarna i en angiven grupp efter dess GroupId och väljer endast Idegenskaperna och DisplayName@odata.type för varje medlem.

  • -GroupId anger ID för en grupp.

Exempel 2: Hämta två gruppmedlemmar

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

Det här exemplet visar hur du hämtar de två översta grupperna från Microsoft Entra ID. Du kan använda -Limit som ett alias för -Top.

  • -GroupId anger ID för en grupp.

Exempel 3: Hämta alla medlemmar i en grupp efter grupp-ID

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

Det här exemplet hämtar alla medlemmar i en grupp efter grupp-ID.

  • -GroupId anger ID för en grupp.

Exempel 4: Hämta en gruppmedlem efter ID

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

Det här exemplet visar hur du hämtar gruppmedlem efter ID.

  • -GroupId Anger ID för en grupp.

Parametrar

-All

Visa en lista över alla sidor.

Parameteregenskaper

Typ:System.Management.Automation.SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-GroupId

Anger ID för en grupp i Microsoft Entra ID.

Parameteregenskaper

Typ:System.String
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:Objekt-ID

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-Property

Anger egenskaper som ska returneras

Parameteregenskaper

Typ:

System.String[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:Select

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Top

Anger det maximala antalet poster som ska returneras.

Parameteregenskaper

Typ:System.Int32
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:Limit

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.