Document Details
Automation Child Runbooks
❌
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 (e.g., Start-AzAutomationRunbook, PowerShell Workflow), with all examples and guidance provided exclusively in PowerShell syntax. There is no mention of Linux/Unix shell scripting, Python runbooks, or cross-platform approaches. Windows/PowerShell patterns and modules are presented as the default and only option, with no Linux or non-PowerShell alternatives discussed.
Recommendations:
- Add equivalent examples using Python runbooks, which are supported in Azure Automation and are cross-platform.
- Include references to Bash or other Linux shell scripting options where applicable, or explicitly state their support status.
- Clarify which features and cmdlets are available or behave differently on Linux Hybrid Runbook Workers.
- Balance the documentation by providing Linux-first or at least parallel Linux examples alongside PowerShell/Windows ones.
- Mention any limitations or differences for Linux users up front, and provide links to Linux-specific guidance if available.
Create pull request
Scan History
| Date | Scan ID | Status | Bias Status |
|---|---|---|---|
| 2025-07-12 23:44 | #41 | in_progress | ❌ 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
$vm = Get-AzVM -ResourceGroupName "LabRG" -Name "MyVM"
$output = PSWF-ChildRunbook -VM $vm -RepeatCount 2 -Restart $true
# Ensure that the runbook does not inherit an AzContext
Disable-AzContextAutosave -Scope Process
# Connect to Azure with system-assigned managed identity
$AzureContext = (Connect-AzAccount -Identity).context
# set and store context
$AzureContext = Set-AzContext -SubscriptionName $AzureContext.Subscription -DefaultProfile $AzureContext
$params = @{"VMName"="MyVM";"RepeatCount"=2;"Restart"=$true}
Start-AzAutomationRunbook `
-AutomationAccountName 'MyAutomationAccount' `
-Name 'Test-ChildRunbook' `
-ResourceGroupName 'LabRG' `
-DefaultProfile $AzureContext `
-Parameters $params -Wait
$vm = Get-AzVM -ResourceGroupName "LabRG" -Name "MyVM"
$output = .\PS-ChildRunbook.ps1 -VM $vm -RepeatCount 2 -Restart $true