Get-EntraAdministrativeUnitMember

Módulo:
Microsoft.Entra.DirectoryManagement Module v1.3

Obtiene un miembro de una unidad administrativa.

Sintaxis

Default (valor predeterminado) 

Get-EntraAdministrativeUnitMember

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

Description

El Get-EntraAdministrativeUnitMember cmdlet obtiene un miembro de una unidad administrativa de Microsoft Entra ID. Especifique AdministrativeUnitId los parámetros para recuperar un miembro de la unidad administrativa.

En escenarios delegados con cuentas profesionales o educativas, el usuario que ha iniciado sesión debe ser un usuario miembro o tener asignado un rol de Microsoft Entra compatible o un rol personalizado con los permisos necesarios. Se admiten los siguientes roles con privilegios mínimos para esta operación:

  • Lectores de directorio: leer propiedades básicas en unidades administrativas
  • Lector global: leer todas las propiedades de las unidades administrativas, incluidos los miembros
  • Administrador de roles con privilegios: cree y administre unidades administrativas (incluidos los miembros)

Ejemplos

Ejemplo 1: Obtener un miembro de unidad administrativa por AdministrativeUnitId

Connect-Entra -Scopes 'AdministrativeUnit.ReadWrite.All'
$administrativeUnit = Get-EntraAdministrativeUnit -Filter "DisplayName eq '<administrativeunit-display-name>'"
Get-EntraAdministrativeUnitMember -AdministrativeUnitId $administrativeUnit.Id |
Select-Object Id, DisplayName, '@odata.type', createdDateTime

id                                   DisplayName         @odata.type              CreatedDateTime
--                                   -----------         -----------              ---------------
bbbbbbbb-1111-2222-3333-cccccccccccc Alex Wilber        #microsoft.graph.user    10/7/2024 12:31:51 AM
cccccccc-2222-3333-4444-dddddddddddd Adele Miller      #microsoft.graph.user    10/7/2024 12:32:17 AM
dddddddd-3333-4444-5555-eeeeeeeeeeee Sales and Marketing #microsoft.graph.group  10/7/2024 12:43:47 AM
ffffffff-5555-6666-7777-aaaaaaaaaaaa Contoso Global     #microsoft.graph.group   10/27/2024 6:48:09 AM

En este ejemplo se devuelve la lista de miembros de unidades administrativas de la unidad administrativa Especificada AdministrativeUnitId.

  • -AdministrativeUnitId parameter especifica el identificador de una unidad administrativa.

Ejemplo 2: Obtener todos los miembros de la unidad administrativa por AdministrativeUnitId

Connect-Entra -Scopes 'AdministrativeUnit.ReadWrite.All'
$administrativeUnit = Get-EntraAdministrativeUnit -Filter "DisplayName eq '<administrativeunit-display-name>'"
Get-EntraAdministrativeUnitMember -AdministrativeUnitId $administrativeUnit.Id -All |
Select-Object Id, DisplayName, '@odata.type', createdDateTime

id                                   DisplayName         @odata.type              CreatedDateTime
--                                   -----------         -----------              ---------------
bbbbbbbb-1111-2222-3333-cccccccccccc Alex Wilber        #microsoft.graph.user    10/7/2024 12:31:51 AM
cccccccc-2222-3333-4444-dddddddddddd Adele Miller      #microsoft.graph.user    10/7/2024 12:32:17 AM
dddddddd-3333-4444-5555-eeeeeeeeeeee Sales and Marketing #microsoft.graph.group  10/7/2024 12:43:47 AM
ffffffff-5555-6666-7777-aaaaaaaaaaaa Contoso Global     #microsoft.graph.group   10/27/2024 6:48:09 AM

En este ejemplo se devuelve la lista de todos los miembros de unidad administrativa de la unidad administrativa Especificada AdministrativeUnitId.

  • -AdministrativeUnitId parameter especifica el identificador de una unidad administrativa.

Ejemplo 3: Obtener los tres miembros principales de la unidad administrativa por AdministrativeUnitId

Connect-Entra -Scopes 'AdministrativeUnit.ReadWrite.All'
$administrativeUnit = Get-EntraAdministrativeUnit -Filter "DisplayName eq '<administrativeunit-display-name>'"
Get-EntraAdministrativeUnitMember -AdministrativeUnitId $administrativeUnit.Id -Top 3 |
Select-Object Id, DisplayName, '@odata.type', createdDateTime

id                                   DisplayName         @odata.type              CreatedDateTime
--                                   -----------         -----------              ---------------
bbbbbbbb-1111-2222-3333-cccccccccccc Alex Wilber        #microsoft.graph.user    10/7/2024 12:31:51 AM
cccccccc-2222-3333-4444-dddddddddddd Adele Miller      #microsoft.graph.user    10/7/2024 12:32:17 AM
dddddddd-3333-4444-5555-eeeeeeeeeeee Sales and Marketing #microsoft.graph.group  10/7/2024 12:43:47 AM

En este ejemplo se devuelven los tres miembros principales de la unidad administrativa del identificador de unidad administrativa especificado. Puede usar -Limit como alias para -Top.

  • -AdministrativeUnitId parameter especifica el identificador de una unidad administrativa.

Parámetros

-AdministrativeUnitId

Especifica el identificador de una unidad administrativa en Microsoft Entra ID.

Propiedades de parámetro

Tipo:System.String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:ObjectId (identificador de objeto)

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-All

Enumera todas las páginas.

Propiedades de parámetro

Tipo:System.Management.Automation.SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Property

Especifica las propiedades que se van a devolver.

Propiedades de parámetro

Tipo:

System.String[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:Select

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Top

Especifica el número máximo de registros que se van a devolver.

Propiedades de parámetro

Tipo:System.Int32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:Limit

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.