Detected Bias Types
Powershell Heavy
Windows First
Missing Linux Example
🔧
Windows Tools
Summary
The documentation page for configuring runbook input parameters in Azure Automation exhibits a notable Windows/PowerShell bias. Most examples, code snippets, and workflows are based on PowerShell, PowerShell Workflow, or graphical runbooks (which are PowerShell-based). The only Linux-relevant section is for Python runbooks, which is brief and lacks parity in depth and example coverage compared to PowerShell. All command-line examples for starting runbooks use PowerShell cmdlets, with no mention of Bash, Azure CLI, or Linux-native tooling. The JSON passing example is exclusively PowerShell-based, and SDK examples use C#, which is more common in Windows environments. There is no guidance for Linux/macOS users on how to interact with runbooks using Azure CLI or Bash scripts.
Recommendations
- Add equivalent Azure CLI examples for starting runbooks and passing parameters, including JSON objects.
- Provide Bash script examples for interacting with the Azure Automation REST API.
- Expand the Python runbook section with more detailed parameter handling examples, including complex types and best practices.
- Clarify which features or examples are platform-agnostic and which are PowerShell/Windows-specific.
- Include notes or links for Linux/macOS users on how to install and use Azure CLI and Python for Azure Automation tasks.