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
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 are in PowerShell, and references to modules, environment variables, and system paths are Windows-specific (e.g., $env:TEMP, C:\temp). Windows tools like WinSCP.exe and IIS are mentioned as module dependencies, with no Linux equivalents or examples provided. There is minimal mention of Linux or Bash scripting, and Linux-specific scenarios are not addressed, leading to a lack of parity for Linux users.
Recommendations:
- Provide equivalent Bash or Python examples for common runbook tasks, especially for error handling and file operations.
- Include Linux-specific guidance for Hybrid Runbook Workers, such as recommended temp directories (e.g., /tmp) and handling of permissions/elevation.
- Mention Linux-compatible tools and modules (e.g., sftp, curl, Apache/Nginx) alongside Windows tools like WinSCP and IIS.
- Clarify which features, modules, and cmdlets are supported on Linux Hybrid Runbook Workers, and document any differences.
- Add a section or examples for authoring and running Python runbooks, which are supported in Azure Automation and are cross-platform.
- Balance references to environment variables and file paths by including both Windows and Linux formats (e.g., $env:TEMP and /tmp).
Create pull request
Scan History
| Date | Scan ID | Status | Bias Status |
|---|---|---|---|
| 2025-08-17 00:01 | #83 | in_progress | ✅ Clean |
| 2025-07-13 21:37 | #48 | completed | ✅ Clean |
| 2025-07-09 13:09 | #3 | cancelled | ✅ Clean |
| 2025-07-08 04:23 | #2 | cancelled | ❌ Biased |
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.