Document Details
Custom Roles Template
❌
This page contains Windows bias
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 exclusively uses Azure PowerShell commands and Cloud Shell for all deployment, verification, and cleanup steps, with no mention of Azure CLI, Bash, or Linux-native workflows. All code samples and instructions assume a PowerShell environment, which is more familiar to Windows users. There are no Linux or cross-platform command examples, and PowerShell is presented as the default and only method.
Recommendations:
- Add equivalent Azure CLI (az) command examples for all deployment, verification, and cleanup steps, using Bash syntax where appropriate.
- Explicitly mention that Azure Cloud Shell supports both Bash and PowerShell, and provide instructions for both environments.
- Where possible, provide guidance for running commands on Linux/macOS terminals, not just Windows/PowerShell.
- Reorder or parallelize examples so that Linux/Bash and Windows/PowerShell instructions are given equal prominence.
- Include notes or links to documentation for installing and using Azure CLI and PowerShell on all supported platforms.
Create pull request
Scan History
| Date | Scan ID | Status | Bias Status |
|---|---|---|---|
| 2025-09-16 00:00 | #113 | completed | ✅ Clean |
| 2025-09-15 00:00 | #112 | completed | ✅ Clean |
| 2025-09-14 00:00 | #111 | completed | ✅ Clean |
| 2025-09-13 00:00 | #110 | completed | ✅ Clean |
| 2025-09-12 00:00 | #109 | completed | ✅ Clean |
| 2025-09-11 00:00 | #108 | completed | ✅ Clean |
| 2025-09-10 00:00 | #107 | completed | ✅ Clean |
| 2025-08-17 00:01 | #83 | in_progress | ✅ Clean |
| 2025-07-13 21:37 | #48 | completed | ✅ Clean |
| 2025-07-12 23:44 | #41 | in_progress | ❌ Biased |
Flagged Code Snippets
1. Enter a location for the deployment such as `centralus`.
1. Enter a list of actions for the custom role as a comma-separated list such as `Microsoft.Resources/resources/read,Microsoft.Resources/subscriptions/resourceGroups/read`.
1. If necessary, press Enter to run the `New-AzDeployment` command.
The [New-AzDeployment](/powershell/module/az.resources/new-azdeployment) command deploys the template to create the custom role.
You should see output similar to the following:
## Review deployed resources
Follow these steps to verify that the custom role was created.
1. Run the [Get-AzRoleDefinition](/powershell/module/az.resources/get-azroledefinition) command to list the custom role.