Edit

Share via

Remove-EntraUserManager

Module:
Microsoft.Entra.Users Module v1.1

Removes a user's manager.

Syntax

Default (Default) 

Remove-EntraUserManager

    -UserId <String>
    [<CommonParameters>]

Description

The Remove-EntraUserManager cmdlet removes a user's manager in Microsoft Entra ID. Specify the UserId parameter to remove the manager for a user in Microsoft Entra ID.

Examples

Example 1: Remove the manager of a user

Connect-Entra -Scopes 'User.ReadWrite.All'
Remove-EntraUserManager -UserId 'SawyerM@Contoso.com'

This example shows how to remove a user's manager.

You can use Get-EntraUser command to get the user's details.

Example 2: Remove the manager of a user via pipelining

Connect-Entra -Scopes 'User.ReadWrite.All'
Get-EntraUser -UserId 'SawyerM@Contoso.com' | Remove-EntraUserManager

This example shows how to remove a user's manager.

Parameters

-UserId

Specifies the ID of a user (as a User Principle Name or ObjectId) in Microsoft Entra ID.

Parameter properties

Type:System.String
Default value:None
Supports wildcards:False
DontShow:False
Aliases:ObjectId, UPN, Identity, UserPrincipalName

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.