Edit

Share via


Remove-EntraBetaAdministrativeUnitMember

Removes an administrative unit member.

Syntax

Default (Default)

Remove-EntraBetaAdministrativeUnitMember

    -AdministrativeUnitId <String>
    -MemberId <String>
    [<CommonParameters>]

Description

The Remove-EntraBetaAdministrativeUnitMember cmdlet removes an administrative unit member in Microsoft Entra ID. Specify AdministrativeUnitId and MemberId to remove an administrative unit member.

To remove a member from an administrative unit, the calling principal must have at least the Privileged Role Administrator role in Microsoft Entra.

Examples

Example 1: Remove an administrative unit member

Connect-Entra -Scopes 'AdministrativeUnit.Read.All'
$administrativeUnit = Get-EntraBetaAdministrativeUnit -Filter "DisplayName eq 'Pacific Administrative Unit'"
$adminUnitMember = Get-EntraBetaAdministrativeUnitMember -AdministrativeUnitId $administrativeUnit.Id | Select-Object Id, DisplayName,'@odata.type' | Where-Object {$_.DisplayName -eq 'Saywer Miller'}
Remove-EntraBetaAdministrativeUnitMember -AdministrativeUnitId $administrativeUnit.Id -MemberId $adminUnitMember.Id

This command removes a specified member (user or group) from a specified administrative unit.

  • -AdministrativeUnitId parameter specifies the ID of an administrative unit.
  • -MemberId parameter specifies the ID of the administrative unit member.

Parameters

-AdministrativeUnitId

Specifies the ID of an administrative unit in Microsoft Entra ID.

Parameter properties

Type:System.String
Default value:None
Supports wildcards:False
DontShow:False
Aliases:ObjectId

Parameter sets

(All)
Position:Named
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:True
Value from remaining arguments:False

-MemberId

Specifies the ID of the administrative unit member.

Parameter properties

Type:System.String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:True
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.