Get-EntraAdministrativeUnit
Hiermee haalt u een beheereenheid op.
Syntax
GetQuery (Standaard)
Get-EntraAdministrativeUnit
[-Top <Int32>]
[-All]
[-Filter <String>]
[-Property <String[]>]
[<CommonParameters>]
GetById
Get-EntraAdministrativeUnit
-AdministrativeUnitId <String>
[-All]
[-Property <String[]>]
[<CommonParameters>]
Description
De Get-EntraAdministrativeUnit cmdlet haalt een Microsoft Entra ID beheereenheid op. Geef AdministrativeUnitId de parameter op om een specifieke beheereenheid op te halen.
Voorbeelden
Voorbeeld 1: Alle beheereenheden ophalen
Connect-Entra -Scopes 'AdministrativeUnit.Read.All'
Get-EntraAdministrativeUnit
DeletedDateTime Id Description DisplayName Visibility
--------------- -- ----------- ----------- ----------
dddddddd-3333-4444-5555-eeeeeeeeeeee Updated Description Updated DisplayName
cccccccc-2222-3333-4444-dddddddddddd testdemo test1
bbbbbbbb-1111-2222-3333-cccccccccccc TestAU
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb test_130624_09
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb demotest test111
Met deze opdracht worden alle beheereenheden ophaalt.
Voorbeeld 2: Alle beheereenheden ophalen met de parameter '-All'
Connect-Entra -Scopes 'AdministrativeUnit.Read.All'
Get-EntraAdministrativeUnit -All
DeletedDateTime Id Description DisplayName Visibility
--------------- -- ----------- ----------- ----------
dddddddd-3333-4444-5555-eeeeeeeeeeee Updated Description Updated DisplayName
cccccccc-2222-3333-4444-dddddddddddd testdemo test1
bbbbbbbb-1111-2222-3333-cccccccccccc TestAU
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb test_130624_09
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb demotest test111
Met deze opdracht worden alle beheereenheden ophaalt.
Voorbeeld 3: Een specifieke beheereenheid ophalen
Connect-Entra -Scopes 'AdministrativeUnit.Read.All'
Get-EntraAdministrativeUnit -AdministrativeUnitId 'aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb'
DeletedDateTime Id Description DisplayName Visibility
--------------- -- ----------- ----------- ----------
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb Updated Description Updated DisplayName
In dit voorbeeld worden de details van de opgegeven beheereenheid geretourneerd.
-
-AdministrativeUnitIdparameter geeft de id van een beheereenheid.
Voorbeeld 4: Beheereenheden filteren op weergavenaam
Connect-Entra -Scopes 'AdministrativeUnit.Read.All'
Get-EntraAdministrativeUnit -Filter "DisplayName eq 'DAU-Test'"
DeletedDateTime Id Description DisplayName Visibility
--------------- -- ----------- ----------- ----------
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb Dynamic AU testing in CORP tenant DAU-Test
In deze voorbeeldlijst met beheereenheden met de weergavenaam met de opgegeven naam.
Voorbeeld 5: Top één beheereenheid ophalen
Connect-Entra -Scopes 'AdministrativeUnit.Read.All'
Get-EntraAdministrativeUnit -Top 1
DeletedDateTime Id Description DisplayName Visibility
--------------- -- ----------- ----------- ----------
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb Dynamic AU testing in CORP tenant DAU-Test
In dit voorbeeld worden de opgegeven belangrijkste beheereenheden geretourneerd. U kunt -Limit gebruiken als alias voor -Top.
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
GetById
| 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 |
-Filter
Hiermee geeft u een OData v4.0-filterinstructie op. Deze parameter filtert welke objecten worden geretourneerd.
Parametereigenschappen
| Type: | System.String |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
GetQuery
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | True |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| 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
GetQuery
| 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.