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:
⚠️
windows_first
⚠️
powershell_heavy
⚠️
missing_linux_example
Summary:
The documentation provides both Azure PowerShell and Azure CLI examples for network configuration tasks, but PowerShell commands are consistently listed before Azure CLI commands. There are no Linux shell or Bash-specific examples, and the documentation does not mention Linux-native tools or patterns (such as Bash scripting or Linux command-line utilities) for network management. The focus on PowerShell and the ordering of examples may give the impression of a Windows-centric approach, despite HDInsight clusters themselves being Linux-based.
Recommendations:
- Alternate the order of PowerShell and Azure CLI examples, or present Azure CLI (which is cross-platform) first, especially since HDInsight clusters are Linux-based.
- Explicitly mention that Azure CLI commands can be run natively on Linux, macOS, and Windows, and provide Bash script snippets where appropriate.
- Include references or examples using Linux-native tools (e.g., curl, dig, nslookup) for network diagnostics alongside Azure CLI/PowerShell.
- Clarify that PowerShell is available cross-platform, but highlight Azure CLI as the primary tool for Linux users.
- Where possible, provide context or links for Linux users on installing and using Azure CLI and other relevant tools.
Create pull request
Flagged Code Snippets
Get-AzNetworkSecurityGroup -ResourceGroupName "RESOURCEGROUP"
Get-AzRouteTable -ResourceGroupName "RESOURCEGROUP"
$clusterNICs = Get-AzNetworkInterface -ResourceGroupName "RESOURCEGROUP" | where-object {$_.Name -like "*node*"}
$nodes = @()
foreach($nic in $clusterNICs) {
$node = new-object System.Object
$node | add-member -MemberType NoteProperty -name "Type" -value $nic.Name.Split('-')[1]
$node | add-member -MemberType NoteProperty -name "InternalIP" -value $nic.IpConfigurations.PrivateIpAddress
$node | add-member -MemberType NoteProperty -name "InternalFQDN" -value $nic.DnsSettings.InternalFqdn
$nodes += $node
}
$nodes | sort-object Type