[Utilities] Fixing Update-NestedRoleAssignmentList.ps1 script to support 'Microsoft.Authorization/roleAssignments' module

[krbar]

Description

The PR resolves #2292 and fixes the script Update-NestedRoleAssignmentList.ps1 to also update the built-in roles in the 'Microsoft.Authorization/roleAssignments' and its sub-modules.

Background:
Unlike all other modules, the list of built-in roles in the module 'Microsoft.Authorization/roleAssignments' is not stored in the file .bicep/nested_roleAssignments.bicep, but in the deploy.bicep files of the child-modules. This caused that the old logic of the Update-NestedRoleAssignmentList.ps1 was not able to find and update the roles there.

Details:

• Updates of the script Get-RoleAssignmentList.ps1
  • no filtering of roles for 'Microsoft.Authorization/roleAssignments'. Returning all non-custom roles.
  • different output format for 'Microsoft.Authorization/roleAssignments'
• renaming the script Update-NestedRoleAssignmentList.ps1 and its functions: removing "Nested" from the name: Update-RoleAssignmentList.ps1
• update of the Update-RoleAssignmentList.ps1 to cover the special case of the module 'Microsoft.Authorization/roleAssignments'
• modifications of the module 'Microsoft.Authorization/roleAssignments'
  • renaming variable builtInRoleNamesVar to builtInRoleNames in the child modules of 'Microsoft.Authorization/roleAssignments'. This aligns the name of this variable to match all other modules, which simplifies the update process.
  • alphabetical sort of the roles list
  • update of the roles list (using the Update-RoleAssignmentList.ps1)

Pipeline references

For module/pipeline changes, please create and attach the status badge of your successful run.

Pipeline

Type of Change

• Bugfix (non-breaking change which fixes an issue)

Checklist

• I'm sure there are no other open Pull Requests for the same update/change
• My corresponding pipelines / checks run clean and green without any errors or warnings
• My code follows the style guidelines of this project
• I have commented my code, particularly in hard-to-understand areas
• I have made corresponding changes to the documentation (readme)
• I did format my code