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

missing_linux_example

Summary

The documentation page demonstrates a moderate Windows bias. While the main examples use Azure CLI (which is cross-platform), there are several instances where Windows-specific shells (CMD, PowerShell) are mentioned before or instead of Linux equivalents. Formatting for parameters and variables is explained for Windows shells, but Linux/Bash alternatives are not always provided or are described second. There is little explicit mention of Linux tools or patterns, and some examples (such as variable assignment and array formatting) are Windows-centric.

Recommendations

Ensure all shell-specific instructions are provided for both Windows (CMD/PowerShell) and Linux (Bash) users, with equal prominence.
When describing parameter formatting or variable assignment, give Bash/Linux examples first or side-by-side with Windows examples.
Explicitly mention that Azure CLI is cross-platform and provide links or notes about using it on Linux/macOS.
Include troubleshooting or usage notes relevant to Linux environments (e.g., file permissions, path formats).
Add more examples that use Linux/Bash syntax, especially for variable assignment, parameter passing, and scripting.
Avoid assuming Windows as the default environment; clarify instructions for both platforms where differences exist.

Create Pull Request

Scan History

Date	Scan	Status	Result
2026-01-12 00:00	#99	completed	Biased
2026-01-11 06:20	#98	completed	Biased
2026-01-10 00:00	#92	completed	Clean
2026-01-09 00:00	#87	cancelled	Clean
2026-01-06 22:28	#78	completed	Clean
2025-12-29 18:00	#48	cancelled	Biased
2025-12-15 00:00	#7	completed	Clean
2025-12-14 05:05	#6	completed	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.