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_first
⚠️
missing_linux_example
Summary:
The documentation page demonstrates a strong Windows bias in its command-line examples. All variable assignment and scripting examples use Windows batch syntax (set, for /f, %var%), with no equivalent Bash or Linux shell examples provided. This can confuse or exclude Linux/macOS users, despite the Azure CLI being cross-platform. There is also a tendency to present Windows-style commands first or exclusively, and the documentation does not mention or show Linux-native patterns for variable usage or scripting.
Recommendations:
- Provide equivalent Bash/Linux shell examples for all scripting and variable assignment sections, using export, $(...), and $VAR syntax.
- Clearly indicate which code blocks are for Windows (cmd) and which are for Linux/macOS (bash), using tabs or callouts.
- In introductory sections, avoid language that suggests Windows as the default platform; mention Linux and macOS equally.
- Where possible, use cross-platform command examples, or explicitly show both Windows and Linux/macOS variants side by side.
- Link to Azure CLI documentation on using variables in both Bash and Windows shells.
Create pull request
Flagged Code Snippets
set resourceGroup=myResourceGroup
set subscription=123e4567-e89b-12d3-a456-426614174000
set workspace=default
set firmwareID=sampleFirmwareID
for /f "tokens=*" %i in ('az firmwareanalysis workspace generate-upload-url --resource-group %resourceGroup% --subscription %subscription% --workspace-name %workspace% --firmware-id %firmwareID% --query "url"') do set sasURL=%i
az storage blob upload -f "pathToFile" --blob-url %sasURL%
set filePath="/path/to/image"
set resourceGroup="myResourceGroup"
set workspace="default"
set fileName="file1"
set vendor="vendor1"
set model="model"
set version="test"
for /f "tokens=*" %i in ('az firmwareanalysis firmware create --resource-group %resourceGroup% --workspace-name %workspace% --file-name %fileName% --vendor %vendor% --model %model% --version %version% --query "name"') do set FWID=%i
for /f "tokens=*" %i in ('az firmwareanalysis workspace generate-upload-url --resource-group %resourceGroup% --workspace-name %workspace% --firmware-id %FWID% --query "url"') do set URL=%i
az storage blob upload -f %filePath% --blob-url %URL%
set resourceGroup="myResourceGroup"
set workspace="default"
set FWID="yourFirmwareID"
for /f "tokens=*" %i in ('az firmwareanalysis firmware show --resource-group %resourceGroup% --workspace-name %workspace% --firmware-id %FWID% --query "id"') do set ID=%i
echo Successfully created a firmware image with the firmware ID of %FWID%, recognized in Azure by this resource ID: %ID%.
for /f "tokens=*" %i in ('az resource wait --ids %ID% --custom "properties.status=='Ready'" --timeout 10800') do set WAIT=%i
for /f "tokens=*" %i in ('az resource show --ids %ID% --query "properties.status"') do set STATUS=%i
echo firmware analysis completed with status: %STATUS%