Get-EntraUserAdministrativeUnit

Module:
Microsoft.Entra.Users Module v1.3

Hiermee wordt de lijst met beheereenheden opgehaald waartoe een gebruiker behoort.

Syntax

GetQuery (Standaard) 

Get-EntraUserAdministrativeUnit

    -UserId <String>
    [-All]
    [-Top <Int32>]
    [-Property <String[]>]
    [-Filter <String>]
    [<CommonParameters>]

GetById 

Get-EntraUserAdministrativeUnit

    -UserId <String>
    -AdministrativeUnitId <String>
    [-Property <String[]>]
    [<CommonParameters>]

Description

De Get-EntraUserAdministrativeUnit cmdlet haalt een lijst met beheereenheden op waartoe een gebruiker behoort.

Voorbeelden

Voorbeeld 1: Een lijst met beheereenheden ophalen waartoe een specifieke gebruiker behoort

Connect-Entra -Scopes 'AdministrativeUnit.Read.All'
Get-EntraUserAdministrativeUnit -UserId 'SawyerM@contoso.com'

DeletedDateTime Id                                   Description                            DisplayName             Visibility
--------------- --                                   -----------                            -----------             ----------
                dddddddd-3333-4444-5555-eeeeeeeeeeee Pacific Administrative Unit            Pacific Admin Unit
                aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb Engineering Administrative Unit        Engineering Admin Unit

Met deze cmdlet wordt een lijst met beheereenheden opgehaald waartoe een specifieke gebruiker behoort.

Voorbeeld 2: Een lijst met beheereenheden ophalen waartoe een specifieke gebruiker behoort met behulp van de parameter All

Connect-Entra -Scopes 'AdministrativeUnit.Read.All'
Get-EntraUserAdministrativeUnit -UserId 'SawyerM@contoso.com' -All

DeletedDateTime Id                                   Description                            DisplayName             Visibility
--------------- --                                   -----------                            -----------             ----------
                dddddddd-3333-4444-5555-eeeeeeeeeeee Pacific Administrative Unit            Pacific Admin Unit
                aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb Engineering Administrative Unit        Engineering Admin Unit

Met deze cmdlet wordt een lijst met beheereenheden opgehaald waartoe een specifieke gebruiker behoort met behulp van de parameter All.

Voorbeeld 3: Een beheereenheid ophalen waartoe een specifieke gebruiker behoort

Connect-Entra -Scopes 'AdministrativeUnit.Read.All'
Get-EntraUserAdministrativeUnit -UserId 'SawyerM@contoso.com' -Top 1

DeletedDateTime Id                                   Description                            DisplayName             Visibility
--------------- --                                   -----------                            -----------             ----------
                dddddddd-3333-4444-5555-eeeeeeeeeeee Pacific Administrative Unit            Pacific Admin Unit

Met deze cmdlet wordt een beheereenheid opgehaald waartoe een specifieke gebruiker behoort. U kunt -Limit gebruiken als alias voor -Top.

Voorbeeld 4: Een lijst met beheereenheden ophalen waartoe een specifieke gebruiker behoort met behulp van de parameter Beheereenheid-id

Connect-Entra -Scopes 'AdministrativeUnit.Read.All'
$administrativeUnit = Get-EntraAdministrativeUnit -Filter "DisplayName eq 'Pacific Admin Unit'"
Get-EntraUserAdministrativeUnit -UserId 'SawyerM@contoso.com' -AdministrativeUnitId $administrativeUnit.Id

DeletedDateTime Id                                   Description                            DisplayName             Visibility
--------------- --                                   -----------                            -----------             ----------
                dddddddd-3333-4444-5555-eeeeeeeeeeee Pacific Administrative Unit            Pacific Admin Unit

Met deze cmdlet wordt een lijst opgehaald met beheereenheden waartoe een specifieke gebruiker behoort met behulp van de parameter Beheereenheid-id.

  • -AdministrativeUnitId parameter geeft de id van de beheereenheid.

Voorbeeld 5: Een beheereenheid ophalen waartoe een specifieke gebruiker behoort

Connect-Entra -Scopes 'AdministrativeUnit.Read.All'
Get-EntraUserAdministrativeUnit -UserId 'SawyerM@contoso.com' -Filter "Id eq 'dddddddd-3333-4444-5555-eeeeeeeeeeee'"

DeletedDateTime Id                                   Description                            DisplayName             Visibility
--------------- --                                   -----------                            -----------             ----------
                dddddddd-3333-4444-5555-eeeeeeeeeeee Pacific Administrative Unit            Pacific Admin Unit

Met deze cmdlet wordt een beheereenheid opgehaald waartoe een specifieke gebruiker behoort.

Parameters

-AdministrativeUnitId

De unieke id van de beheereenheid.

Parametereigenschappen

Type:System.String
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:DirectoryObjectId

Parametersets

GetQuery
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. Met deze parameter bepaalt u 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

Het maximum aantal beheereenheden waartoe een gebruiker behoort.

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

-UserId

Hiermee geeft u de id van een gebruiker (als UserPrincipalName of ObjectId) in Microsoft Entra ID.

Parametereigenschappen

Type:System.String
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:ObjectId, UPN, Identity, Hoofdgebruikersnaam

Parametersets

GetQuery
Position:Named
Verplicht:True
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.

Uitvoerwaarden

System.Object