Document Details
Automation Runbook Execution
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 page demonstrates a strong Windows and PowerShell bias. All code examples use PowerShell syntax, and the only scripting environments discussed in detail are PowerShell, PowerShell Workflow, and graphical runbooks (which are Windows-centric). Windows tools and concepts (such as WMI, .NET Framework, UAC, and Windows file paths like C:\temp) are referenced exclusively or before any Linux equivalents. There are no examples or explicit guidance for Linux shell scripting, Bash, or Python runbooks, and Linux-specific operational patterns are not discussed. The documentation assumes a Windows-centric perspective throughout.
Recommendations
- Add examples and guidance for Python runbooks, which are supported in Azure Automation and are more cross-platform.
- Include Linux/Bash scripting examples where relevant, especially in sections on error handling, temporary storage, and process execution.
- When discussing file paths (e.g., C:\temp), also mention Linux equivalents (e.g., /tmp) and clarify OS-specific differences.
- Reference Linux tools and APIs (such as /proc, systemd, or Linux performance counters) alongside Windows tools like WMI.
- In module and environment discussions, clarify which modules and features are available or behave differently on Linux Hybrid Runbook Workers.
- Provide parity in troubleshooting and operational guidance for both Windows and Linux environments.
- Explicitly mention Linux support and limitations in each relevant section, not just in security or monitoring contexts.
Create Pull Request
Scan History
| Date | Scan | Status | Result |
|---|---|---|---|
| 2025-07-12 23:44 | #41 | cancelled |
Biased
|
| 2025-07-12 00:58 | #8 | cancelled |
 Clean
|
| 2025-07-10 05:06 | #7 | processing |
Clean
|
| 2025-07-09 23:22 | #6 | cancelled |
Clean
|
Flagged Code Snippets
### Try Catch Finally [Try Catch Finally](/powershell/module/microsoft.powershell.core/about/about_try_catch_finally) is used in PowerShell scripts to handle terminating errors. The script can use this mechanism to catch specific exceptions or general exceptions. The `catch` statement should be used to track or try to handle errors. The following example tries to download a file that doesn't exist. It catches the `System.Net.WebException` exception and returns the last value for any other exception.
### Throw [Throw](/powershell/module/microsoft.powershell.core/about/about_throw) can be used to generate a terminating error. This mechanism can be useful when defining your own logic in a runbook. If the script meets a criterion that should stop it, it can use the `throw` statement to stop. The following example uses this statement to show a required function parameter.