Set-EntraDirectoryRoleDefinition

Set-EntraDirectoryRoleDefinition

    [-TemplateId <String>]
    [-DisplayName <String>]
    [-RolePermissions <System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.RolePermission]>]
    -UnifiedRoleDefinitionId <String>
    [-Description <String>]
    [-Version <String>]
    [-IsEnabled <Boolean>]
    [-ResourceScopes <System.Collections.Generic.List`1[System.String]>]
    [<CommonParameters>]

Hiermee wordt een Microsoft Entra roleDefinition-object bijgewerkt dat wordt geïdentificeerd door id. U kunt ingebouwde rollen niet bijwerken. 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

Connect-Entra -Scopes 'RoleManagement.ReadWrite.Directory'
$roleDefinition = Get-EntraDirectoryRoleDefinition -Filter "DisplayName eq '<Role-Definition-Name>'"
Set-EntraDirectoryRoleDefinition -UnifiedRoleDefinitionId $roleDefinition.Id -DisplayName 'UpdatedDisplayName'

In dit voorbeeld wordt de opgegeven roldefinitie in Microsoft Entra ID bijgewerkt.

• -UnifiedRoleDefinitionId parameter geeft de object-id roleDefinition op.
• -DisplayName parameter geeft de weergavenaam voor de roldefinitie.

Connect-Entra -Scopes 'RoleManagement.ReadWrite.Directory'
$roleDefinition = Get-EntraDirectoryRoleDefinition -Filter "DisplayName eq '<Role-Definition-Name>'"
Set-EntraDirectoryRoleDefinition -UnifiedRoleDefinitionId $roleDefinition.Id -Description 'MYROLEUPDATE1S'

In dit voorbeeld wordt de beschrijving van de opgegeven roldefinitie in Microsoft Entra ID bijgewerkt.

• -UnifiedRoleDefinitionId parameter geeft de object-id roleDefinition op.
• -Description parameter geeft de beschrijving voor de roldefinitie.

Connect-Entra -Scopes 'RoleManagement.ReadWrite.Directory'
$roleDefinition = Get-EntraDirectoryRoleDefinition -Filter "DisplayName eq '<Role-Definition-Name>'"
Set-EntraDirectoryRoleDefinition -UnifiedRoleDefinitionId $roleDefinition.Id -IsEnabled $true

In dit voorbeeld wordt de IsEnabled van de opgegeven roldefinitie in Microsoft Entra ID bijgewerkt.

• -UnifiedRoleDefinitionId parameter geeft de object-id roleDefinition op.
• -IsEnabled parameter geeft aan of de roldefinitie is ingeschakeld.

Connect-Entra -Scopes 'RoleManagement.ReadWrite.Directory'
$roleDefinition = Get-EntraDirectoryRoleDefinition -Filter "DisplayName eq '<Role-Definition-Name>'"
$rolePermissions = New-object Microsoft.Open.MSGraph.Model.RolePermission
$rolePermissions.AllowedResourceActions = @("microsoft.directory/applications/standard/read")
$params = @{
    UnifiedRoleDefinitionId = $roleDefinition.Id
    Description             = 'Update'
    DisplayName             = 'Update'
    ResourceScopes          = '/'
    IsEnabled               = $false
    RolePermissions         = $rolePermissions
    TemplateId              = 'f2ef992c-3afb-46b9-b7cf-a126ee74c451'
    Version                 = 2
}
Set-EntraDirectoryRoleDefinition @params

In dit voorbeeld worden de RolePermissions, TemplateId, TemplateId, ResourceScopes van de opgegeven roldefinitie in Microsoft Entra ID bijgewerkt.

• -UnifiedRoleDefinitionId parameter geeft de object-id roleDefinition op.
• -RolePermissions parameter geeft de machtigingen voor de roldefinitie.
• -IsEnabled parameter geeft aan of de roldefinitie is ingeschakeld.
• -DisplayName parameter geeft de weergavenaam voor de roldefinitie.
• -Description parameter geeft de beschrijving voor de roldefinitie.
• -ResourceScopes parameter geeft de resourcebereiken voor de roldefinitie.
• -TemplateId parameter geeft de sjabloon-id voor de roldefinitie.
• -Version parameter geeft de versie voor de roldefinitie.

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

Set-EntraRoleDefinition is een alias voor Set-EntraDirectoryRoleDefintion.