Get-EntraDirectoryRoleMember

Modul:
Microsoft.Entra.DirectoryManagement Module v1.3

Hämtar medlemmar i en katalogroll.

Syntax

Default (Standard) 

Get-EntraDirectoryRoleMember

    -DirectoryRoleId <String>
    [-Property <String[]>]
    [<CommonParameters>]

Description

Cmdleten Get-EntraDirectoryRoleMember hämtar medlemmarna i en katalogroll i Microsoft Entra ID. Om du vill hämta medlemmarna i en specifik katalogroll anger du DirectoryRoleId. Använd cmdleten Get-EntraDirectoryRole för att hämta DirectoryRoleId värdet.

I delegerade scenarier med arbets- eller skolkonton måste den inloggade användaren ha en Microsoft Entra roll som stöds eller en anpassad roll med nödvändiga behörigheter. Följande minst privilegierade roller stöds för den här åtgärden:

  • Användaradministratör
  • Supportadministratör
  • Tjänstsupportadministratör
  • Faktureringsadministratör
  • Katalogläsare
  • Katalogförfattare
  • Appadministratör
  • Säkerhetsläsare
  • säkerhetsadministratör
  • Privilegierad rolladministratör
  • Applikationsadministratör för molnet

Exempel

Exempel 1: Hämta medlemmar efter roll-ID

Connect-Entra -Scopes 'RoleManagement.Read.Directory'
$directoryRole = Get-EntraDirectoryRole -Filter "displayName eq 'Helpdesk Administrator'"
Get-EntraDirectoryRoleMember -DirectoryRoleId $directoryRole.Id | Select Id, DisplayName, '@odata.type', CreatedDateTime

id                                   displayName     @odata.type            createdDateTime
--                                   -----------     -----------            ---------------
bbbbbbbb-7777-8888-9999-cccccccccccc Debra Berger    #microsoft.graph.user  10/7/2024 12:31:57 AM
cccccccc-2222-3333-4444-dddddddddddd Contoso Group   #microsoft.graph.group 11/12/2024 9:59:43 AM

Det här exemplet hämtar medlemmarna i den angivna rollen.

  • -DirectoryRoleId parameter anger katalogroll-ID.

Parametrar

-DirectoryRoleId

Anger ID för en katalogroll 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

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.