Get-EntraAdministrativeUnit

Módulo:
Microsoft.Entra.DirectoryManagement Module v1.3

Obtiene una unidad administrativa.

Sintaxis

GetQuery (valor predeterminado) 

Get-EntraAdministrativeUnit

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

GetById 

Get-EntraAdministrativeUnit

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

Description

El Get-EntraAdministrativeUnit cmdlet obtiene un Microsoft Entra ID unidad administrativa. Especifique AdministrativeUnitId el parámetro para obtener una unidad administrativa específica.

Ejemplos

Ejemplo 1: Obtener todas las unidades administrativas

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

Este comando obtiene todas las unidades administrativas.

Ejemplo 2: Obtención de todas las unidades administrativas mediante el parámetro "-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

Este comando obtiene todas las unidades administrativas.

Ejemplo 3: Obtener una unidad administrativa específica

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

En este ejemplo se devuelven los detalles de la unidad administrativa especificada.

  • -AdministrativeUnitId parameter especifica el identificador de una unidad administrativa.

Ejemplo 4: Obtener el filtro de unidades administrativas por nombre para mostrar

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

En esta lista de ejemplos de unidades administrativas que contienen el nombre para mostrar con el nombre especificado.

Ejemplo 5: Obtener una unidad administrativa superior

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

En este ejemplo se devuelven las unidades administrativas principales especificadas. Puede usar -Limit como alias para -Top.

Parámetros

-AdministrativeUnitId

Especifica el identificador de una unidad administrativa en Microsoft Entra ID.

Propiedades de parámetro

Tipo:System.String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:ObjectId (identificador de objeto)

Conjuntos de parámetros

GetById
Posición:Named
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-All

Enumera todas las páginas.

Propiedades de parámetro

Tipo:System.Management.Automation.SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Filter

Especifica una instrucción de filtro de OData v4.0. Este parámetro filtra qué objetos se devuelven.

Propiedades de parámetro

Tipo:System.String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

GetQuery
Posición:Named
Obligatorio:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-Property

Especifica las propiedades que se van a devolver.

Propiedades de parámetro

Tipo:

System.String[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:Select

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Top

Especifica el número máximo de registros que se van a devolver.

Propiedades de parámetro

Tipo:System.Int32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:Limit

Conjuntos de parámetros

GetQuery
Posición:Named
Obligatorio:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.