This page contains Windows bias

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
Summary:
The documentation provides both Azure CLI and PowerShell examples for configuring Azure Firewall DNS settings, but the PowerShell examples are prominent and detailed, reflecting a bias toward Windows-centric tooling. There are no Linux-specific command-line examples (such as Bash scripts or Linux-native tools), and PowerShell is presented as an equal alternative to CLI, despite being primarily a Windows tool. The documentation does not mention or address Linux-specific considerations or workflows, and the ordering of examples sometimes places PowerShell before or at parity with CLI, which may not reflect the cross-platform user base.
Recommendations:
  • Add explicit Bash shell examples for all CLI commands, demonstrating usage in a typical Linux environment.
  • Clarify that Azure CLI is cross-platform and can be used on Windows, macOS, and Linux, while PowerShell is primarily for Windows users (unless using PowerShell Core).
  • Consider providing Linux-specific notes or troubleshooting tips, such as how to restart network services on Linux VMs after DNS changes.
  • Where possible, lead with CLI/Bash examples before PowerShell, as CLI is more universally accessible across platforms.
  • Include references or links to Linux administration documentation for related tasks (e.g., updating DNS settings on Linux VMs).
GitHub Create pull request

Scan History

Date Scan ID Status Bias Status
2025-08-17 00:01 #83 in_progress ✅ Clean
2025-07-13 21:37 #48 completed ❌ Biased
2025-07-09 13:09 #3 cancelled ✅ Clean
2025-07-08 04:23 #2 cancelled ❌ Biased

Flagged Code Snippets

#### [PowerShell](#tab/powershell) You can use Azure PowerShell to configure DNS proxy settings in Azure Firewall. You can also use it to update virtual networks to use Azure Firewall as the DNS server. ##### Configure virtual network DNS servers The following example configures the virtual network to use Azure Firewall as a DNS server.
> [!IMPORTANT] > The command `az network firewall` requires the Azure CLI extension `azure-firewall` to be installed. You can install it by using the command `az extension add --name azure-firewall`. #### [PowerShell](#tab/powershell) The following example updates Azure Firewall with custom DNS servers by using Azure PowerShell.