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
⚠️
missing_linux_example
⚠️
windows_tools
⚠️
windows_first
Summary:
The documentation page demonstrates a strong Windows bias. All command-line examples use Azure PowerShell cmdlets, with no mention of Azure CLI or Bash equivalents, which are more commonly used on Linux and macOS. The DNS testing example uses nslookup in a Windows PowerShell prompt, and there are no examples using dig or host, which are standard on Linux. The documentation refers to Windows tools and patterns exclusively and does not provide Linux-specific guidance or parity.
Recommendations:
- Provide Azure CLI (az) command examples alongside or in place of PowerShell for all DNS record creation and web app configuration steps.
- Include DNS query examples using dig and/or host, which are standard on Linux, in addition to or instead of nslookup.
- Avoid showing only PowerShell prompts (e.g., 'PS C:\>') and instead use generic shell prompts or show both Windows and Linux terminal examples.
- Explicitly mention that the steps can be performed from any OS, and provide links or notes for installing required tools on Linux/macOS.
- Consider restructuring the documentation to present cross-platform examples side-by-side, or default to Azure CLI, which is cross-platform.
Create pull request
Flagged Code Snippets
New-AzDnsRecordSet -ZoneName contoso.com -ResourceGroupName "MyAzureResourceGroup" `
-Name "www" -RecordType "CNAME" -Ttl 600 `
-DnsRecords (New-AzDnsRecordConfig -cname "contoso.azurewebsites.net")
Name : www
ZoneName : contoso.com
ResourceGroupName : myazureresourcegroup
Ttl : 600
Etag : 8baceeb9-4c2c-4608-a22c-229923ee185
RecordType : CNAME
Records : {contoso.azurewebsites.net}
Tags : {}
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"
New-AzDnsRecordSet -ZoneName contoso.com -ResourceGroupName MyAzureResourceGroup `
-Name "@" -RecordType "txt" -Ttl 600 `
-DnsRecords (New-AzDnsRecordConfig -Value "contoso.azurewebsites.net")