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
⚠️
missing_linux_example
⚠️
windows_tools
⚠️
windows_first
Summary:
The documentation page demonstrates a strong Windows bias by exclusively providing Azure PowerShell examples for deploying and cleaning up ARM templates, with no mention or examples of equivalent steps using Azure CLI, Bash, or other cross-platform tools. The instructions assume use of Azure Cloud Shell for PowerShell, and all command-line steps and outputs are PowerShell-specific. There is no guidance for Linux/macOS users or those preferring Bash/Azure CLI, and the 'Next steps' section links only to further PowerShell-based tutorials.
Recommendations:
- Add equivalent Azure CLI (az) examples for all deployment 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.
- Include sample outputs for Azure CLI commands to match the PowerShell output shown.
- In the 'Next steps' section, link to tutorials using Azure CLI and/or Bash, not just PowerShell.
- Review terminology and instructions to ensure they are not PowerShell- or Windows-centric (e.g., avoid assuming familiarity with PowerShell cmdlets).
Create pull request
Flagged Code Snippets
$resourceGroupName = Read-Host -Prompt "Enter a resource group name (i.e. ExampleGrouprg)"
$emailAddress = Read-Host -Prompt "Enter an email address for a user in your directory"
$location = Read-Host -Prompt "Enter a location (i.e. centralus)"
$roleAssignmentName = New-Guid
$principalId = (Get-AzAdUser -Mail $emailAddress).id
$roleDefinitionId = (Get-AzRoleDefinition -name "Virtual Machine Contributor").id
$templateUri = "https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.authorization/rbac-builtinrole-resourcegroup/azuredeploy.json"
New-AzResourceGroup -Name $resourceGroupName -Location $location
New-AzResourceGroupDeployment -ResourceGroupName $resourceGroupName -TemplateUri $templateUri -roleDefinitionID $roleDefinitionId -principalId $principalId
PS> New-AzResourceGroupDeployment -ResourceGroupName $resourceGroupName -TemplateUri $templateUri -roleAssignmentName $roleAssignmentName -roleDefinitionID $roleDefinitionId -principalId $principalId
DeploymentName : azuredeploy
ResourceGroupName : ExampleGrouprg
ProvisioningState : Succeeded
Timestamp : 5/22/2020 9:01:30 PM
Mode : Incremental
TemplateLink :
Uri : https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.authorization/rbac-builtinrole-resourcegroup/azuredeploy.json
ContentVersion : 1.0.0.0
Parameters :
Name Type Value
==================== ========================= ==========
roleDefinitionID String 9980e02c-c2be-4d73-94e8-173b1dc7cf3c
principalId String {principalId}
Outputs :
DeploymentDebugLogLevel :
$emailAddress = Read-Host -Prompt "Enter the email address of the user with the role assignment to remove"
$resourceGroupName = Read-Host -Prompt "Enter the resource group name to remove (i.e. ExampleGrouprg)"
$principalId = (Get-AzAdUser -Mail $emailAddress).id
Remove-AzRoleAssignment -ObjectId $principalId -RoleDefinitionName "Virtual Machine Contributor" -ResourceGroupName $resourceGroupName
Remove-AzResourceGroup -Name $resourceGroupName