Get-EntraBetaAdministrativeUnit

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

Obtiene una unidad administrativa.

Sintaxis

GetQuery (valor predeterminado) 

Get-EntraBetaAdministrativeUnit

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

GetById 

Get-EntraBetaAdministrativeUnit

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

Description

El Get-EntraBetaAdministrativeUnit 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-EntraBetaAdministrativeUnit

DeletedDateTime Id                                   Description          DisplayName         IsMemberManagementRestricted Visibility
--------------- --                                   -----------          -----------         ---------------------------- ----------
                aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb Updated Description  Updated DisplayName
                bbbbbbbb-1111-2222-3333-cccccccccccc test111              test111
                cccccccc-2222-3333-4444-dddddddddddd                      TestAU
                dddddddd-3333-4444-5555-eeeeeeeeeeee                      test_130624_09
                eeeeeeee-4444-5555-6666-ffffffffffff test111              test111
                ffffffff-5555-6666-7777-aaaaaaaaaaaa                      test66
                aaaaaaaa-6666-7777-8888-bbbbbbbbbbbb test111              test111             True

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-EntraBetaAdministrativeUnit -All

DeletedDateTime Id                                   Description          DisplayName         IsMemberManagementRestricted Visibility
--------------- --                                   -----------          -----------         ---------------------------- ----------
                aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb Updated Description  Updated DisplayName
                bbbbbbbb-1111-2222-3333-cccccccccccc test111              test111
                cccccccc-2222-3333-4444-dddddddddddd                      TestAU
                dddddddd-3333-4444-5555-eeeeeeeeeeee                      test_130624_09
                eeeeeeee-4444-5555-6666-ffffffffffff test111              test111
                ffffffff-5555-6666-7777-aaaaaaaaaaaa                      test66
                aaaaaaaa-6666-7777-8888-bbbbbbbbbbbb test111              test111             True

Este comando obtiene todas las unidades administrativas.

Ejemplo 3: Obtener una unidad administrativa específica

Connect-Entra -Scopes 'AdministrativeUnit.Read.All'
Get-EntraBetaAdministrativeUnit -AdministrativeUnitId 'aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb'

DeletedDateTime Id                                   Description          DisplayName         IsMemberManagementRestricted 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-EntraBetaAdministrativeUnit -Filter "DisplayName eq 'Updated DisplayName'"

DeletedDateTime Id                                   Description          DisplayName         IsMemberManagementRestricted Visibility
--------------- --                                   -----------          -----------         ---------------------------- ----------
                aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb Updated Description  Updated DisplayName

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-EntraBetaAdministrativeUnit -Top 1

DeletedDateTime Id                                   Description          DisplayName         IsMemberManagementRestricted Visibility
--------------- --                                   -----------          -----------         ---------------------------- ----------
                aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb Updated Description  Updated DisplayName

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:Id

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.