Automation Child Runbooks - Document Details

About This Page

This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.

View on GitHub 📚 View on Microsoft Learn

Bias Analysis

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

$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