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 provides both Windows and Linux options for connecting hybrid machines to Azure Arc, but there is a noticeable Windows bias. Windows tools (PowerShell, Windows-specific CLI install links) are often mentioned first, and PowerShell examples are given in detail, while Linux-specific command-line examples are less emphasized. The troubleshooting section and some notes are Windows-centric, and the agent installation script section explicitly calls out Windows PowerShell limitations without similar Linux caveats. There is a lack of parity in example depth and troubleshooting for Linux users.
Recommendations
- Present Linux and Windows options in parallel, rather than listing Windows first.
- Provide equally detailed Linux shell (bash) examples alongside PowerShell examples, including troubleshooting steps.
- Add Linux-specific notes and caveats where relevant, similar to the Windows PowerShell note.
- Ensure that all tool references (CLI, portal, scripts) are equally accessible and explained for Linux users.
- Include screenshots or walkthroughs for Linux onboarding, not just Windows/portal.
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
|