Get-EntraAdministrativeUnitMember
Hämtar en medlem i en administrativ enhet.
Syntax
Default (Standard)
Get-EntraAdministrativeUnitMember
-AdministrativeUnitId <String>
[-All]
[-Top <Int32>]
[-Property <String[]>]
[<CommonParameters>]
Description
Cmdleten Get-EntraAdministrativeUnitMember hämtar en medlem i en Microsoft Entra ID administrativ enhet. Ange AdministrativeUnitId parametrar för att hämta en administrativ enhetsmedlem.
I delegerade scenarier med arbets- eller skolkonton måste den inloggade användaren antingen vara medlem eller tilldelas 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:
- Katalogläsare: Läsa grundläggande egenskaper för administrativa enheter
- Global läsare: Läs alla egenskaper för administrativa enheter, inklusive medlemmar
- Privilegierad rolladministratör: Skapa och hantera administrativa enheter (inklusive medlemmar)
Exempel
Exempel 1: Hämta en administrativ enhetsmedlem av 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
Det här exemplet returnerar listan över administrativa enhetsmedlemmar från den angivna administrativa enheten AdministrativeUnitId.
-
-AdministrativeUnitIdparameter anger ID för en administrativ enhet.
Exempel 2: Hämta alla administrativa enhetsmedlemmar av 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
Det här exemplet returnerar listan över alla administrativa enhetsmedlemmar från den angivna administrativa enheten AdministrativeUnitId.
-
-AdministrativeUnitIdparameter anger ID för en administrativ enhet.
Exempel 3: Hämta de tre främsta medlemmarna i den administrativa enheten efter 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
Det här exemplet returnerar de tre främsta medlemmarna i den administrativa enheten från det angivna administrativa enhets-ID:t. Du kan använda -Limit som ett alias för -Top.
-
-AdministrativeUnitIdparameter anger ID för en administrativ enhet.
Parametrar
-AdministrativeUnitId
Anger ID för en administrativ enhet 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 |
-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 |
-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.