Document Details
Troubleshooting
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
powershell_heavy
windows_first
missing_linux_example
Summary
The troubleshooting documentation for workload orchestration in Azure Arc shows a notable Windows bias. Most command-line examples outside the 'service groups' section are given only in PowerShell syntax, with no Bash or Linux shell equivalents. Tasks such as registry management, token handling, and image inspection use PowerShell-specific constructs and variables, which may not work natively on Linux/macOS. Only the 'service groups' section provides both Bash and PowerShell tabs, while the majority of troubleshooting steps assume a Windows/PowerShell environment.
Recommendations
- Provide Bash/Linux shell equivalents for all PowerShell commands, especially for az CLI, kubectl, and docker operations.
- Avoid using PowerShell-specific syntax (e.g., variable assignment, piping to ConvertTo-Json, Out-File) in generic Azure CLI or Kubernetes examples; use cross-platform syntax or clearly separate Windows and Linux instructions.
- Explicitly note any platform-specific requirements, and offer guidance for Linux/macOS users where differences exist (e.g., file encoding, JSON creation).
- Where possible, use az CLI commands in a platform-neutral way, and clarify when PowerShell is required.
Create Pull Request
Scan History
| Date | Scan | Status | Result |
|---|---|---|---|
| 2026-02-18 00:00 | #395 | in_progress |
Biased
|
| 2026-02-17 00:00 | #391 | in_progress |
Biased
|
| 2026-02-16 00:00 | #387 | in_progress |
Biased
|
| 2026-02-15 00:00 | #383 | in_progress |
Biased
|
| 2026-02-14 00:00 | #379 | in_progress |
Biased
|
| 2026-02-13 00:00 | #375 | in_progress |
Biased
|
| 2026-02-12 00:00 | #371 | in_progress |
Biased
|
| 2026-02-11 00:00 | #367 | in_progress |
 Clean
|
| 2026-02-10 00:00 | #363 | completed |
Biased
|
| 2026-02-09 00:00 | #359 | completed |
Biased
|
| 2026-02-08 00:00 | #355 | completed |
Biased
|
| 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
|