Remove-EntraAdministrativeUnit

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

Remove uma unidade administrativa.

Sintaxe

Default (Predefinição) 

Remove-EntraAdministrativeUnit

    -AdministrativeUnitId <String>
    [<CommonParameters>]

Descrição

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

Para eliminar uma unidade administrativa, o principal que chama deve ter pelo menos o papel de Administrador de Funções Privilegiadas no 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

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

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

Exemplo 2: Remover uma unidade administrativa através do pipeline

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

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

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

(All)
Posto:Named
Obrigatório:True
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.