Get-EntraAdministrativeUnit
Recebe uma unidade administrativa.
Sintaxe
GetQuery (Predefinição)
Get-EntraAdministrativeUnit
[-Top <Int32>]
[-All]
[-Filter <String>]
[-Property <String[]>]
[<CommonParameters>]
GetById
Get-EntraAdministrativeUnit
-AdministrativeUnitId <String>
[-All]
[-Property <String[]>]
[<CommonParameters>]
Descrição
O Get-EntraAdministrativeUnit cmdlet recebe uma unidade administrativa do Microsoft Entra ID. Especifique AdministrativeUnitId um parâmetro para obter uma unidade administrativa específica.
Exemplos
Exemplo 1: Obter todas as 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 recebe todas as unidades administrativas.
Exemplo 2: Obter todas as unidades administrativas usando o 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 recebe todas as unidades administrativas.
Exemplo 3: Arranja uma unidade 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
Este exemplo devolve os detalhes da unidade administrativa especificada.
-
-AdministrativeUnitIdo parâmetro especifica o ID de uma unidade administrativa.
Exemplo 4: Fazer com que as unidades administrativas filtrem por nome de exibição
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
Esta é uma lista de exemplo de unidades administrativas contendo o nome de exibição com o nome especificado.
Exemplo 5: Obtenha a unidade administrativa top one
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
Este exemplo devolve as unidades administrativas superiores especificadas. Você pode usar -Limit como um alias para -Top.
Parâmetros
-AdministrativeUnitId
Especifica o ID de uma unidade administrativa no Microsoft Entra ID.
Propriedades dos parâmetros
| Tipo: | System.String |
| Valor predefinido: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | IdentificadorDoObjeto |
Conjuntos de parâmetros
GetById
| Posto: | Named |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-All
Liste todas as páginas.
Propriedades dos parâmetros
| Tipo: | System.Management.Automation.SwitchParameter |
| Valor predefinido: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Posto: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Filter
Especifica uma instrução de filtro OData v4.0. Este parâmetro filtra quais os objetos que são devolvidos.
Propriedades dos parâmetros
| Tipo: | System.String |
| Valor predefinido: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
GetQuery
| Posto: | Named |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-Property
Especifica propriedades a devolver.
Propriedades dos parâmetros
| Tipo: | System.String[] |
| Valor predefinido: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Select |
Conjuntos de parâmetros
(All)
| Posto: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Top
Especifica o número máximo de registos a devolver.
Propriedades dos parâmetros
| Tipo: | System.Int32 |
| Valor predefinido: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Limit |
Conjuntos de parâmetros
GetQuery
| Posto: | Named |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.