Remove-EntraDirectoryRoleDefinition

Module:
Microsoft.Entra.Governance Module v1.3

Een Microsoft Entra ID Directory roleDefinition-object verwijderen.

Syntax

Default (Standaard) 

Remove-EntraDirectoryRoleDefinition

    -UnifiedRoleDefinitionId <String>
    [<CommonParameters>]

Description

Verwijder een Microsoft Entra ID Directory roleDefinition-object op id.

U kunt ingebouwde rollen niet verwijderen. Voor deze functie is een Microsoft Entra ID P1- of P2-licentie vereist.

In gedelegeerde scenario's moet de aangemelde gebruiker beschikken over een ondersteunde Microsoft Entra rol of een aangepaste rol met de benodigde machtigingen. De minimale rollen die vereist zijn voor deze bewerking zijn:

  • Bevoorrechte Rollenbeheerder

Voorbeelden

Voorbeeld 1: Een opgegeven roldefinitie verwijderen

Connect-Entra -Scopes 'RoleManagement.ReadWrite.Directory'
$role = Get-EntraDirectoryRoleDefinition -Filter "DisplayName eq 'Contoso Custom Role Definition'"
Remove-EntraDirectoryRoleDefinition -UnifiedRoleDefinitionId $role.Id

In dit voorbeeld ziet u hoe u de opgegeven roldefinitie verwijdert uit Microsoft Entra ID.

  • -UnifiedRoleDefinitionId parameter geeft de object-id roleDefinition op.

Parameters

-UnifiedRoleDefinitionId

De unieke id van een object in Microsoft Entra ID.

Parametereigenschappen

Type:System.String
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Id

Parametersets

(All)
Position:0
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

System.String

Uitvoerwaarden

System.Object

Notities

Remove-EntraRoleDefinition is een alias voor Remove-EntraDirectoryRoleDefintion.