Document Details

Dns Web Sites Custom Domain
Home / Scan 41 / Dns Web Sites Custom Domain
❌
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.
GitHub View on GitHub 📚 View on Microsoft Learn

Bias Analysis

Bias Types:
⚠️ powershell_heavy
⚠️ missing_linux_example
⚠️ windows_tools
⚠️ windows_first
Summary:
The documentation is heavily biased toward Windows and PowerShell users. All command-line examples use Azure PowerShell cmdlets, with no mention or examples of equivalent Azure CLI (cross-platform) or Bash commands. The DNS query example uses nslookup in a Windows PowerShell prompt, with no reference to dig or other common Linux tools. The overall flow assumes a Windows environment, with no guidance for Linux or macOS users.
Recommendations:
  • Provide equivalent Azure CLI (az) command examples alongside or in place of PowerShell examples, as Azure CLI is cross-platform and widely used on Linux/macOS.
  • Include DNS query examples using dig (e.g., dig www.contoso.com) in addition to nslookup, and clarify that both tools are available on different platforms.
  • Avoid using Windows-specific prompt notation (e.g., PS C:\>) unless also showing Linux/macOS shell equivalents.
  • Explicitly mention that all steps can be performed on Linux/macOS, and provide any necessary platform-specific notes (such as installing Azure CLI or dig).
  • Consider reordering examples or providing tabs to let users select their preferred platform (Windows/PowerShell, Linux/Bash, macOS/Terminal).
GitHub Create pull request

Scan History

Date Scan ID Status Bias Status
2025-07-12 23:44 #41 in_progress ❌ Biased
2025-07-12 00:58 #8 cancelled ✅ Clean
2025-07-10 05:06 #7 processing ✅ Clean

Flagged Code Snippets

New-AzDnsRecordSet -Name "@" -RecordType "A" -ZoneName "contoso.com" ` -ResourceGroupName "MyAzureResourceGroup" -Ttl 600 ` -DnsRecords (New-AzDnsRecordConfig -IPv4Address "<ip of web app service>")
New-AzDnsRecordSet -ZoneName contoso.com -ResourceGroupName MyAzureResourceGroup ` -Name "@" -RecordType "txt" -Ttl 600 ` -DnsRecords (New-AzDnsRecordConfig -Value "contoso.azurewebsites.net")
New-AzDnsRecordSet -ZoneName contoso.com -ResourceGroupName "MyAzureResourceGroup" ` -Name "www" -RecordType "CNAME" -Ttl 600 ` -DnsRecords (New-AzDnsRecordConfig -cname "contoso.azurewebsites.net")
PS C:\> nslookup Default Server: Default Address: 192.168.0.1 > www.contoso.com Server: default server Address: 192.168.0.1 Non-authoritative answer: Name: <instance of web app service>.cloudapp.net Address: <ip of web app service> Aliases: www.contoso.com contoso.azurewebsites.net <instance of web app service>.vip.azurewebsites.windows.net > contoso.com Server: default server Address: 192.168.0.1 Non-authoritative answer: Name: contoso.com Address: <ip of web app service> > set type=txt > contoso.com Server: default server Address: 192.168.0.1 Non-authoritative answer: contoso.com text = "contoso.azurewebsites.net"
set-AzWebApp ` -Name contoso ` -ResourceGroupName <your web app resource group> ` -HostNames @("contoso.com","www.contoso.com","contoso.azurewebsites.net")