Document Details
Automation Edit Textual Runbook
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_first
windows_tools
missing_linux_example
Summary
The documentation is heavily focused on PowerShell and Windows-centric workflows. All code examples and command-line instructions use Windows PowerShell, with explicit references to Windows file paths (e.g., c:\runbooks) and no mention of Linux, macOS, or cross-platform PowerShell Core (pwsh). There are no examples or guidance for editing runbooks from non-Windows environments, nor any mention of using PowerShell on Linux/macOS or alternative tools.
Recommendations
- Add examples using PowerShell Core (pwsh) on Linux and macOS, including appropriate file path syntax (e.g., /home/user/runbooks).
- Clarify that Az PowerShell modules and Azure Automation can be used cross-platform, and provide instructions for non-Windows environments.
- Avoid using 'Windows PowerShell' as the default term; instead, use 'PowerShell' and specify when something is Windows-specific.
- Include notes or sections on editing and managing runbooks from Linux/macOS, including any limitations or differences.
- Where file paths are shown, provide both Windows and Linux/macOS equivalents.
- Mention or link to Azure CLI or REST API alternatives for users who may not use PowerShell.
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
### Change the contents of a runbook using Windows PowerShell The following sample commands show how to replace the existing contents of a runbook with the contents of a script file.