Remove-EntraAdministrativeUnit

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

Remove uma unidade administrativa.

Sintaxe

Default (Default) 

Remove-EntraAdministrativeUnit

    -AdministrativeUnitId <String>
    [<CommonParameters>]

Description

O Remove-EntraAdministrativeUnit cmdlet remove uma unidade administrativa de Microsoft Entra ID. Especifique AdministrativeUnitId o parâmetro para excluir uma unidade administrativa.

Para excluir uma unidade administrativa, a entidade de chamada deve ter pelo menos a função administrador de função com privilégios em Microsoft Entra.

Exemplos

Exemplo 1: remover uma unidade administrativa

Connect-Entra -Scopes 'AdministrativeUnit.ReadWrite.All'
$administrativeUnit = Get-EntraAdministrativeUnit -Filter "DisplayName eq '<administrative-unit-display-name>'"
Remove-EntraAdministrativeUnit -AdministrativeUnitId $administrativeUnit.Id

Esse comando remove a unidade administrativa especificada do Microsoft Entra ID.

  • -AdministrativeUnitId o parâmetro especifica a ID de uma unidade administrativa.

Exemplo 2: remover uma unidade administrativa por meio de pipelining

Connect-Entra -Scopes 'AdministrativeUnit.ReadWrite.All'
Get-EntraAdministrativeUnit -Filter "DisplayName eq '<administrative-unit-display-name>'" | Remove-EntraAdministrativeUnit

Esse comando remove a unidade administrativa especificada do Microsoft Entra ID.

Parâmetros

-AdministrativeUnitId

Especifica a ID de uma unidade administrativa em Microsoft Entra ID.

Propriedades do parâmetro

Tipo:System.String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:IdentificadorDeObjeto

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes: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.