Get-EntraUserAdministrativeUnit

Modul:
Microsoft.Entra.Users Module v1.3

Načte seznam jednotek pro správu, do nichž uživatel patří.

Syntax

GetQuery (Výchozí) 

Get-EntraUserAdministrativeUnit

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

GetById 

Get-EntraUserAdministrativeUnit

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

Description

Rutina Get-EntraUserAdministrativeUnit načte seznam jednotek pro správu, do kterých uživatel patří.

Příklady

Příklad 1: Získání seznamu jednotek pro správu, ke kterým konkrétní uživatel patří

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

Tato rutina načte seznam jednotek pro správu, do kterých konkrétní uživatel patří.

Příklad 2: Získání seznamu jednotek pro správu, ke kterým konkrétní uživatel patří pomocí parametru Vše

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

Tato rutina načte seznam jednotek pro správu, do kterých konkrétní uživatel patří pomocí parametru All.

Příklad 3: Získání jednotky pro správu, do které patří konkrétní uživatel

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

Tato rutina načte jednotku pro správu, do které patří konkrétní uživatel. Jako alias pro -Limitmůžete použít -Top .

Příklad 4: Získání seznamu jednotek pro správu, ke kterým konkrétní uživatel patří pomocí parametru ID jednotky správy

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

Tato rutina načte seznam jednotek pro správu, do kterých konkrétní uživatel patří pomocí parametru ID jednotky pro správu.

  • -AdministrativeUnitId parametr určuje ID jednotky pro správu.

Příklad 5: Získání jednotky pro správu, do které patří konkrétní uživatel

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

Tato rutina načte jednotku pro správu, do které patří konkrétní uživatel.

Parametry

-AdministrativeUnitId

Jedinečné ID jednotky pro správu.

Vlastnosti parametru

Typ:System.String
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:DirectoryObjectId

Sady parametrů

GetQuery
Position:Named
Povinné:True
Hodnota z kanálu:True
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-All

Zobrazit seznam všech stránek

Vlastnosti parametru

Typ:System.Management.Automation.SwitchParameter
Default value:False
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Filter

Určuje příkaz filtru OData v4.0. Tento parametr určuje, které objekty se vrátí.

Vlastnosti parametru

Typ:System.String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

GetQuery
Position:Named
Povinné:False
Hodnota z kanálu:True
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-Property

Určuje vlastnosti, které se mají vrátit.

Vlastnosti parametru

Typ:

System.String[]

Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:Vyberte

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Top

Maximální počet jednotek pro správu, ke které uživatel patří.

Vlastnosti parametru

Typ:System.Int32
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:Limit

Sady parametrů

GetQuery
Position:Named
Povinné:False
Hodnota z kanálu:True
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-UserId

Určuje ID uživatele (jako UserPrincipalName nebo ObjectId) v Microsoft Entra ID.

Vlastnosti parametru

Typ:System.String
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:Identifikátor objektu (ObjectId), hlavní název uživatele (UPN), Identita, Hlavní jméno uživatele

Sady parametrů

GetQuery
Position:Named
Povinné:True
Hodnota z kanálu:True
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Výstupy

System.Object