Get-EntraAdministrativeUnitMember
Hiermee wordt een lid van een beheereenheid.
Syntax
Default (Standaard)
Get-EntraAdministrativeUnitMember
-AdministrativeUnitId <String>
[-All]
[-Top <Int32>]
[-Property <String[]>]
[<CommonParameters>]
Description
De Get-EntraAdministrativeUnitMember cmdlet haalt een lid op van een Microsoft Entra ID beheereenheid. Geef AdministrativeUnitId parameters op om een lid van een beheereenheid op te halen.
In gedelegeerde scenario's met werk- of schoolaccounts moet de aangemelde gebruiker een lidgebruiker zijn of een ondersteunde Microsoft Entra-rol of een aangepaste rol met de benodigde machtigingen toewijzen. De volgende rollen met minimale bevoegdheden worden ondersteund voor deze bewerking:
- Adreslijstlezers: basiseigenschappen voor beheereenheden lezen
- Globale lezer: alle eigenschappen van beheereenheden lezen, inclusief leden
- Beheerder van bevoorrechte rol: beheereenheden maken en beheren (inclusief leden)
Voorbeelden
Voorbeeld 1: Een lid van een beheereenheid ophalen per 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
In dit voorbeeld wordt de lijst geretourneerd met leden van de beheereenheid uit de opgegeven beheereenheid AdministrativeUnitId.
-
-AdministrativeUnitIdparameter geeft de id van een beheereenheid.
Voorbeeld 2: Alle leden van de beheereenheid ophalen per 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
In dit voorbeeld wordt de lijst geretourneerd met alle leden van de beheereenheid uit de opgegeven beheereenheid AdministrativeUnitId.
-
-AdministrativeUnitIdparameter geeft de id van een beheereenheid.
Voorbeeld 3: De drie belangrijkste leden van de beheereenheid ophalen per 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
In dit voorbeeld worden de drie belangrijkste leden van de beheereenheid geretourneerd op basis van de opgegeven beheereenheid-id. U kunt -Limit gebruiken als alias voor -Top.
-
-AdministrativeUnitIdparameter geeft de id van een beheereenheid.
Parameters
-AdministrativeUnitId
Hiermee geeft u de id van een beheereenheid in Microsoft Entra ID.
Parametereigenschappen
| Type: | System.String |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | ObjectId |
Parametersets
(All)
| Position: | Named |
| Verplicht: | True |
| Waarde uit pijplijn: | True |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
-All
Alle pagina's weergeven.
Parametereigenschappen
| Type: | System.Management.Automation.SwitchParameter |
| Default value: | False |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Property
Hiermee geeft u eigenschappen die moeten worden geretourneerd.
Parametereigenschappen
| Type: | System.String[] |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | Selecteren |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Top
Hiermee geeft u het maximum aantal records dat moet worden geretourneerd.
Parametereigenschappen
| Type: | System.Int32 |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | Limit |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | True |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
CommonParameters
Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.