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
Bias Types:
⚠️
powershell_heavy
⚠️
windows_first
⚠️
missing_linux_example
⚠️
windows_tools
Summary:
The documentation is heavily focused on PowerShell and Windows workflows. All command-line examples use Windows PowerShell, with explicit references to Windows paths (e.g., c:\runbooks) and no mention of Linux or cross-platform PowerShell Core usage. There are no examples or instructions for editing runbooks from Linux or macOS environments, nor is there guidance for using PowerShell Core or Azure CLI as alternatives.
Recommendations:
- Add equivalent examples using PowerShell Core (pwsh) on Linux/macOS, including Unix-style file paths (e.g., /home/user/runbooks).
- Clarify that the Az PowerShell module and cmdlets can be used cross-platform, and provide instructions for installing and using them on Linux/macOS.
- Include Azure CLI examples for exporting/importing runbooks, if supported, to provide a non-PowerShell alternative.
- Avoid using 'Windows PowerShell' as the default term; use 'PowerShell' or specify when instructions apply to Windows-only environments.
- Explicitly state platform compatibility for each method, and provide troubleshooting or caveats for non-Windows users.
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 | ❌ Biased |
| 2025-07-09 13:09 | #3 | cancelled | ✅ Clean |
| 2025-07-08 04:23 | #2 | cancelled | ❌ Biased |
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.