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:
⚠️
windows_first
⚠️
powershell_heavy
Summary:
The documentation provides both Windows and Linux examples for most ARM/Bicep template scenarios, and covers Linux-specific hosting plans (e.g., Flex Consumption, Container Apps, Azure Arc) in detail. However, there is a consistent pattern of presenting Windows examples and terminology before Linux equivalents, especially in code tabs and explanatory text. Additionally, the only explicit command-line deployment examples outside of Azure CLI are for PowerShell, with no Bash or cross-platform shell equivalents provided. Some references to tools (e.g., Visual Studio Code extensions) are cross-platform, but the deployment section is PowerShell-centric.
Recommendations:
- Alternate the order of Windows and Linux examples/tabs, or present Linux first where it is the default or recommended platform.
- Provide Bash or cross-platform shell equivalents for all PowerShell deployment examples, especially for template deployment and resource group creation.
- Explicitly mention that all ARM/Bicep templates and Azure CLI commands are cross-platform, and provide sample commands for both Windows and Linux environments.
- Where possible, use neutral language (e.g., 'on your system' instead of 'on Windows') unless the content is truly OS-specific.
- Highlight Linux-specific considerations or best practices earlier in the document, not only as addenda to Windows instructions.
Create pull request
Flagged Code Snippets
### [Visual Studio Code](#tab/vs-code)
In [Visual Studio Code](https://code.visualstudio.com/), install the latest [Bicep extension](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-bicep) or [Azure Resource Manager Tools extension](https://marketplace.visualstudio.com/items?itemName=msazurermtools.azurerm-vscode-tools).
These extensions report syntactic errors in your code before deployment. For some examples of errors, see the [Fix validation error](../azure-resource-manager/troubleshooting/quickstart-troubleshoot-arm-deployment.md#fix-validation-error) section of the troubleshooting article.
---
You can also create a test resource group to find [preflight](../azure-resource-manager/troubleshooting/quickstart-troubleshoot-arm-deployment.md?tabs=azure-cli#fix-preflight-error) and [deployment](../azure-resource-manager/troubleshooting/quickstart-troubleshoot-arm-deployment.md?tabs=azure-cli#fix-deployment-error) errors.
## Deploy your template
You can use any of the following ways to deploy your Bicep file and template:
### [Bicep](#tab/bicep)
- [Azure CLI](../azure-resource-manager/bicep/deploy-cli.md)
- [PowerShell](../azure-resource-manager/bicep/deploy-powershell.md)
### [ARM template](#tab/json)
- [Azure portal](../azure-resource-manager/templates/deploy-portal.md)
- [Azure CLI](../azure-resource-manager/templates/deploy-cli.md)
- [PowerShell](../azure-resource-manager/templates/deploy-powershell.md)
---
### Deploy to Azure button
> [!NOTE]
> This method doesn't support deploying Bicep files currently.
Replace
# Register Resource Providers if they're not already registered
Register-AzResourceProvider -ProviderNamespace "microsoft.web"
Register-AzResourceProvider -ProviderNamespace "microsoft.storage"
# Create a resource group for the function app
New-AzResourceGroup -Name "MyResourceGroup" -Location 'West Europe'
# Deploy the template
New-AzResourceGroupDeployment -ResourceGroupName "MyResourceGroup" -TemplateFile main.bicep -Verbose
# Register Resource Providers if they're not already registered
Register-AzResourceProvider -ProviderNamespace "microsoft.web"
Register-AzResourceProvider -ProviderNamespace "microsoft.storage"
# Create a resource group for the function app
New-AzResourceGroup -Name "MyResourceGroup" -Location 'West Europe'
# Deploy the template
New-AzResourceGroupDeployment -ResourceGroupName "MyResourceGroup" -TemplateFile azuredeploy.json -Verbose