Get-EntraBetaAdministrativeUnitMember
Gets a member of an administrative unit.
Syntax
Default (Default)
Get-EntraBetaAdministrativeUnitMember
-AdministrativeUnitId <String>
[-All]
[-Top <Int32>]
[-Property <String[]>]
[<CommonParameters>]
Description
The Get-EntraBetaAdministrativeUnitMember cmdlet gets a member of a Microsoft Entra ID administrative unit. Specify AdministrativeUnitId parameters to retrieve an administrative unit member.
In delegated scenarios with work or school accounts, the signed-in user must either be a member user or be assigned a supported Microsoft Entra role, or a custom role with the necessary permissions. The following least privileged roles are supported for this operation:
- Directory Readers: Read basic properties on administrative units
- Global Reader: Read all properties of administrative units, including members
- Privileged Role Administrator: Create and manage administrative units (including members)
Examples
Example 1: Get an administrative unit member by AdministrativeUnitId
Connect-Entra -Scopes 'AdministrativeUnit.ReadWrite.All'
$administrativeUnit = Get-EntraBetaAdministrativeUnit -Filter "DisplayName eq '<administrativeunit-display-name>'"
Get-EntraBetaAdministrativeUnitMember -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
This example returns the list of administrative unit members from specified administrative unit ObjectId.
-AdministrativeUnitIdparameter specifies the ID of an administrative unit.
Example 2: Get all administrative unit members by AdministrativeUnitId
Connect-Entra -Scopes 'AdministrativeUnit.ReadWrite.All'
$administrativeUnit = Get-EntraBetaAdministrativeUnit -Filter "DisplayName eq '<administrativeunit-display-name>'"
Get-EntraBetaAdministrativeUnitMember -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
This example returns the list of all administrative unit members from specified administrative unit ObjectId.
-AdministrativeUnitIdparameter specifies the ID of an administrative unit.
Example 3: Get top three administrative unit members by AdministrativeUnitId
Connect-Entra -Scopes 'AdministrativeUnit.ReadWrite.All'
$administrativeUnit = Get-EntraBetaAdministrativeUnit -Filter "DisplayName eq '<administrativeunit-display-name>'"
Get-EntraBetaAdministrativeUnitMember -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
This example returns top three administrative unit members from specified administrative unit ObjectId. You can use -Limit as an alias for -Top.
-AdministrativeUnitIdparameter specifies the ID of an administrative unit.
Parameters
-AdministrativeUnitId
Specifies the ID of an administrative unit in Microsoft Entra ID.
Parameter properties
| Type: | System.String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | ObjectId |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | True |
| Value from pipeline: | True |
| Value from pipeline by property name: | True |
| Value from remaining arguments: | False |
-All
List all pages.
Parameter properties
| Type: | System.Management.Automation.SwitchParameter |
| Default value: | False |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Property
Specifies properties to be returned.
Parameter properties
| Type: | System.String[] |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | Select |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Top
Specifies the maximum number of records to return.
Parameter properties
| Type: | System.Int32 |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | Limit |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | True |
| Value from pipeline by property name: | True |
| Value from remaining arguments: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.