Document Details
Onboard Service Principal
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
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation page demonstrates a moderate Windows bias. Windows and PowerShell are mentioned first or more prominently in several places, such as the creation of service principals and installation scripts. PowerShell examples are provided in detail, while Linux-specific command-line examples are less emphasized or absent. The troubleshooting and agent installation sections also focus on Windows tools and patterns, with limited Linux-specific troubleshooting or automation guidance.
Recommendations
- Ensure Linux examples (e.g., Bash, shell scripting) are provided alongside or before Windows/PowerShell examples.
- Balance the order of presentation so that Linux and Windows instructions alternate or are grouped together, rather than Windows-first.
- Include Linux-specific troubleshooting steps and notes, especially for common issues encountered during onboarding.
- Provide parity in automation guidance, such as sample scripts for Linux environments (e.g., Bash, Ansible) where PowerShell scripts are shown for Windows.
- Explicitly mention cross-platform compatibility for tools like Azure CLI and azcmagent, and clarify any OS-specific limitations.
- Add links to Linux admin guides or best practices for Azure Arc onboarding, similar to those provided for Windows.
Create Pull Request
Scan History
| Date | Scan | Status | Result |
|---|---|---|---|
| 2026-01-22 01:38 | #287 | completed |
 Clean
|
| 2026-01-14 00:00 | #251 | completed |
Biased
|
| 2026-01-13 00:00 | #247 | completed |
Biased
|
| 2026-01-11 00:00 | #241 | completed |
Biased
|
| 2026-01-10 00:00 | #238 | completed |
Biased
|
| 2026-01-09 00:34 | #235 | completed |
Biased
|
| 2026-01-08 00:53 | #232 | completed |
Biased
|