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>]

Actualiza un objeto roleDefinition de Microsoft Entra identificado por id. No se pueden actualizar los roles integrados. Esta característica requiere una licencia Microsoft Entra ID P1 o P2.

En escenarios delegados, el usuario que ha iniciado sesión debe tener un rol de Microsoft Entra compatible o un rol personalizado con los permisos necesarios. Los roles mínimos necesarios para esta operación son:

• Administrador de roles con privilegios

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

En este ejemplo se actualiza la definición de rol especificada en Microsoft Entra ID.

• -UnifiedRoleDefinitionId parameter especifica el identificador de objeto roleDefinition.
• -DisplayName parameter especifica el nombre para mostrar de la definición de roles.

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

En este ejemplo se actualiza la descripción de la definición de roles especificada en Microsoft Entra ID.

• -UnifiedRoleDefinitionId parameter especifica el identificador de objeto roleDefinition.
• -Description el parámetro especifica la descripción de la definición de roles.

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

En este ejemplo se actualiza isEnabled de la definición de roles especificada en Microsoft Entra ID.

• -UnifiedRoleDefinitionId parameter especifica el identificador de objeto roleDefinition.
• -IsEnabled el parámetro especifica si la definición de roles está habilitada.

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

En este ejemplo se actualiza rolePermissions, TemplateId, TemplateId, ResourceScopes de la definición de roles especificada en Microsoft Entra ID.

• -UnifiedRoleDefinitionId parameter especifica el identificador de objeto roleDefinition.
• -RolePermissions el parámetro especifica los permisos para la definición de roles.
• -IsEnabled el parámetro especifica si la definición de roles está habilitada.
• -DisplayName parameter especifica el nombre para mostrar de la definición de roles.
• -Description el parámetro especifica la descripción de la definición de roles.
• -ResourceScopes el parámetro especifica los ámbitos de recursos para la definición de roles.
• -TemplateId el parámetro especifica el identificador de plantilla para la definición de roles.
• -Version el parámetro especifica la versión de la definición de roles.

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Set-EntraRoleDefinition es un alias de Set-EntraDirectoryRoleDefintion.