Deploy Cli - Document Details

About This Page

This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.

View on GitHub 📚 View on Microsoft Learn

Bias Analysis

Detected Bias Types

windows_first

powershell_heavy

windows_tools

Summary

The documentation generally uses cross-platform Azure CLI commands and Bash syntax, but there are several instances where Windows-specific shells (CMD, PowerShell) are mentioned first or exclusively. Examples for handling parameters and variables often provide Bash/Linux syntax first, but Windows-specific instructions are included as secondary notes. There is a lack of parity in providing full PowerShell/CMD examples, and the documentation sometimes assumes familiarity with Windows tools and conventions.

Recommendations

For every example that mentions Windows Command Prompt (CMD) or PowerShell, provide a corresponding, fully worked-out Linux/Bash example, and vice versa.
When discussing shell-specific syntax (e.g., arrays, variables), present Linux/Bash and Windows/PowerShell examples side by side, rather than mentioning one as a note after the other.
Avoid phrases like 'If you're using Azure CLI with Windows Command Prompt (CMD) or PowerShell...' without also including 'If you're using Bash or a Linux shell...' for parity.
Where possible, use neutral, cross-platform examples or explicitly state which shell the example is for, and provide both Linux and Windows variants.
Add a section or table summarizing differences in command syntax between Bash/Linux and Windows/PowerShell for common deployment scenarios.

Create Pull Request

Scan History

Date	Scan	Status	Result
2025-07-12 23:44	#41	cancelled	Biased
2025-07-12 00:58	#8	cancelled	Clean
2025-07-10 05:06	#7	processing	Clean

Flagged Code Snippets

If you're using Azure CLI with Windows Command Prompt (CMD) or PowerShell, pass the array in the format: `exampleArray="['value1','value2']"`.

You can also get the contents of file and provide that content as an inline parameter.

However, if you're using Azure CLI with Windows Command Prompt (CMD) or PowerShell, set the variable to a JSON string. Escape the quotation marks: `$params = '{ \"prefix\": {\"value\":\"start\"}, \"suffix\": {\"value\":\"end\"} }'`.

### JSON parameter files

Rather than passing parameters as inline values in your script, you might find it easier to use a parameters file, either a `.bicepparam` file or a JSON parameters file, that contains the parameter values. The parameters file must be a local file. External parameters files aren't supported with Azure CLI.