Document Details
Runbooks
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_tools
missing_linux_example
windows_first
Summary
The documentation is heavily focused on PowerShell and Windows-centric tools and patterns. All code examples use PowerShell cmdlets, with no equivalent examples for Bash, Azure CLI, or Python (except for a brief mention of Python runbooks in parameter length limits). Windows tools and concepts (e.g., PowerShell ISE, Windows Management Instrumentation, COM servers) are referenced without Linux alternatives. Troubleshooting steps and recommendations consistently use PowerShell modules and commands, and there is no mention of Linux shell scripting, Azure CLI, or cross-platform guidance. The documentation assumes a Windows/PowerShell environment as the default, with little to no consideration for Linux users or those using non-PowerShell automation.
Recommendations
- Provide equivalent examples using Azure CLI and Bash for common troubleshooting scenarios, especially for starting runbooks, authentication, and module management.
- Include Python runbook troubleshooting steps and code samples where relevant, given that Python is supported.
- Reference cross-platform editors (e.g., VS Code) and clarify that runbook authoring and troubleshooting can be performed on Linux and macOS, not just Windows/PowerShell ISE.
- Mention Linux-specific considerations for Hybrid Runbook Workers, such as module installation and environment setup.
- When discussing Windows-specific limitations (e.g., COM servers, WMI), note whether these apply or differ on Linux.
- Add links to Azure CLI documentation and Linux troubleshooting guides for Azure Automation.
- Ensure that troubleshooting steps do not assume PowerShell as the only language or tool, and provide parity for Linux/CLI users.
Create Pull Request
Scan History
| Date | Scan | Status | Result |
|---|---|---|---|
| 2026-01-14 00:00 | #250 | in_progress |
Biased
|
| 2026-01-13 00:00 | #246 | completed |
Biased
|
| 2026-01-12 00:00 | #243 | cancelled |
Biased
|
| 2026-01-11 00:00 | #240 | completed |
Biased
|
| 2026-01-10 00:00 | #237 | completed |
Biased
|
| 2026-01-09 00:34 | #234 | completed |
Biased
|
| 2026-01-08 00:53 | #231 | completed |
Biased
|
| 2026-01-06 18:15 | #225 | cancelled |
 Clean
|
| 2025-08-17 00:01 | #83 | cancelled |
Clean
|
| 2025-07-13 21:37 | #48 | completed |
Clean
|