About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
Bias Types:
⚠️
powershell_heavy
⚠️
windows_tools
⚠️
missing_linux_example
⚠️
windows_first
Summary:
The documentation page demonstrates a strong Windows and PowerShell bias. All command-line examples for configuring Azure RBAC are provided exclusively using Azure PowerShell cmdlets, with no mention or examples of equivalent Azure CLI (cross-platform) commands. The only scripting language shown is PowerShell, which is primarily associated with Windows environments. There is no guidance or examples for Linux/macOS users, nor is there mention of using Azure CLI or REST API for role assignments. The structure and ordering of the documentation also present PowerShell before any other tooling, reinforcing a Windows-first approach.
Recommendations:
- Add equivalent Azure CLI examples for all PowerShell cmdlets shown, especially for role assignment, listing, and removal.
- Explicitly mention that Azure CLI and REST API can be used for these operations, and provide links or examples.
- Where scripts are provided, offer both PowerShell and Bash (Azure CLI) versions side-by-side.
- Clarify that PowerShell is available cross-platform, but also highlight the native experience for Linux/macOS users via Azure CLI.
- Review all sections for implicit assumptions of a Windows environment and update language to be inclusive of Linux/macOS users.
Create pull request
Flagged Code Snippets
[Get-AzRoleAssignment](/powershell/module/az.resources/get-azroleassignment) lists Azure role assignments at the specified scope. Without any parameters, this cmdlet returns all the role assignments made under the subscription. Use the `ExpandPrincipalGroups` parameter to list access assignments for the specified user, as well as the groups that the user belongs to.
**Example:** Use the following cmdlet to list all the users and their roles within an Automation account.
Use [New-AzRoleAssignment](/powershell/module/Az.Resources/New-AzRoleAssignment) to assign access to users, groups, and applications to a particular scope.
**Example:** Use the following command to assign the "Automation Operator" role for a user in the Automation account scope.
Use [Remove-AzRoleAssignment](/powershell/module/Az.Resources/Remove-AzRoleAssignment) to remove access of a specified user, group, or application from a particular scope.
**Example:** Use the following command to remove the user from the Automation Operator role in the Automation account scope.