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
⚠️
windows_tools
⚠️
missing_linux_example
Summary:
The documentation demonstrates a strong Windows bias throughout. All setup and configuration steps are described using Windows-centric tools and workflows, such as Remote Desktop, Server Manager, Microsoft Management Console (MMC), and PowerShell scripts. There are no examples or guidance for performing equivalent tasks on Linux-based systems or using cross-platform tools. The documentation assumes the use of Windows VMs and does not mention or provide alternatives for Linux environments, even though HDInsight clusters themselves run on Linux by default.
Recommendations:
- Provide equivalent instructions for Linux environments, including how to set up and manage users, groups, and certificates using Linux tools (e.g., OpenLDAP, command-line utilities).
- Offer Bash/Azure CLI examples alongside PowerShell scripts for network and resource provisioning.
- Clarify which steps are Windows-specific and which can be performed from any OS, and provide cross-platform alternatives where possible.
- Include guidance for connecting to the domain controller and managing Entra ID from Linux or macOS clients, possibly using RDP alternatives or Azure portal exclusively.
- Document how to generate and manage certificates for LDAPS using OpenSSL and Linux-based certificate stores.
- Explicitly state any prerequisites or limitations if only Windows is supported for certain steps, and suggest workarounds or alternatives for Linux users.
Create pull request
Flagged Code Snippets
$lifetime = Get-Date
New-SelfSignedCertificate -Subject hdifabrikam.com `
-NotAfter $lifetime.AddDays(365) -KeyUsage DigitalSignature, KeyEncipherment `
-Type SSLServerAuthentication -DnsName *.hdifabrikam.com, hdifabrikam.com
Add-AzVirtualNetworkPeering -Name 'HDIVNet-AADDSVNet' -RemoteVirtualNetworkId (Get-AzVirtualNetwork -ResourceGroupName 'HDIFabrikam-CentralUS').Id -VirtualNetwork (Get-AzVirtualNetwork -ResourceGroupName 'HDIFabrikam-WestUS')
Add-AzVirtualNetworkPeering -Name 'AADDSVNet-HDIVNet' -RemoteVirtualNetworkId (Get-AzVirtualNetwork -ResourceGroupName 'HDIFabrikam-WestUS').Id -VirtualNetwork (Get-AzVirtualNetwork -ResourceGroupName 'HDIFabrikam-CentralUS')