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 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
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.