Get-EntraUserAdministrativeUnit

Module:
Microsoft.Entra.Users Module v1.3

Récupère la liste des unités administratives à laquelle appartient un utilisateur.

Syntaxe

GetQuery (Par défaut) 

Get-EntraUserAdministrativeUnit

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

GetById 

Get-EntraUserAdministrativeUnit

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

Description

L’applet Get-EntraUserAdministrativeUnit de commande récupère une liste d’unités administratives auxquelles appartient un utilisateur.

Exemples

Exemple 1 : Obtenir une liste d’unités administratives auxquelles appartient un utilisateur spécifique

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

Cette applet de commande récupère une liste d’unités administratives auxquelles appartient un utilisateur spécifique.

Exemple 2 : Obtenir une liste d’unités administratives auxquelles appartient un utilisateur spécifique à l’aide du paramètre 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

Cette applet de commande récupère une liste d’unités administratives auxquelles appartient un utilisateur spécifique à l’aide du paramètre All.

Exemple 3 : Obtenir une unité administrative à laquelle appartient un utilisateur spécifique

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

Cette applet de commande récupère une unité administrative à laquelle appartient un utilisateur spécifique. Vous pouvez utiliser -Limit comme alias pour -Top.

Exemple 4 : Obtenir la liste des unités administratives auxquelles appartient un utilisateur spécifique à l’aide du paramètre ID d’unité administrative

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

Cette applet de commande récupère une liste d’unités administratives auxquelles appartient un utilisateur spécifique à l’aide du paramètre ID d’unité administrative.

  • -AdministrativeUnitId spécifie l’ID d’unité administrative.

Exemple 5 : Obtenir une unité administrative à laquelle appartient un utilisateur spécifique

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

Cette applet de commande récupère une unité administrative à laquelle appartient un utilisateur spécifique.

Paramètres

-AdministrativeUnitId

ID unique de l’unité administrative.

Propriétés du paramètre

Type:System.String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:DirectoryObjectId

Jeux de paramètres

GetQuery
Position:Named
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-All

Répertorier toutes les pages.

Propriétés du paramètre

Type:System.Management.Automation.SwitchParameter
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Filter

Spécifie une instruction de filtre OData v4.0. Ce paramètre contrôle les objets retournés.

Propriétés du paramètre

Type:System.String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

GetQuery
Position:Named
Obligatoire:False
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-Property

Spécifie les propriétés à retourner

Propriétés du paramètre

Type:

System.String[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Sélectionnez

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Top

Nombre maximal d’unités administratives à laquelle appartient un utilisateur.

Propriétés du paramètre

Type:System.Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Limite

Jeux de paramètres

GetQuery
Position:Named
Obligatoire:False
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-UserId

Spécifie l’ID d’un utilisateur (en tant que UserPrincipalName ou ObjectId) dans Microsoft Entra ID.

Propriétés du paramètre

Type:System.String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Identifiant d'objet (ObjectId), UPN, Identité, Nom Principal de l'Utilisateur

Jeux de paramètres

GetQuery
Position:Named
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Sorties

System.Object