Edit

Share via

Remove-EntraRoleDefinition

  • Reference
Module:
Microsoft.Graph.Entra

Delete a Microsoft Entra ID roleDefinition by ObjectId.

Syntax

Remove-EntraRoleDefinition
       -Id <String> 
      [<CommonParameters>]

Description

Delete a Microsoft Entra ID roleDefinition object by ID.

You can't delete built-in roles. This feature requires a Microsoft Entra ID P1 or P2 license.

Examples

Example 1: Remove a specified role definition

Connect-Entra -Scopes 'RoleManagement.ReadWrite.Directory'
 Remove-EntraRoleDefinition -Id a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1

This example demonstrates how to remove the specified role definition from Microsoft Entra ID.

Parameters

-Id

The unique identifier of an object in Microsoft Entra ID.

Type:System.String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Inputs

string