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_first

missing_linux_example

windows_tools

Summary

The documentation page is heavily focused on PowerShell-based runbooks and Windows-centric tools and patterns. All examples use PowerShell syntax and cmdlets, such as Start-AzAutomationRunbook, Get-AzVM, and Disable-AzContextAutosave, with no mention of Linux-native scripting languages (e.g., Bash, Python) or cross-platform alternatives. Windows/PowerShell terminology is used exclusively, and there are no Linux or non-PowerShell examples or guidance. The documentation assumes the user is working in a Windows/PowerShell environment, omitting Linux-specific considerations and parity.

Recommendations

Provide equivalent examples using Python runbooks, which are supported in Azure Automation and commonly used on Linux.
Include Bash or shell script runbook examples and guidance for Linux users.
Mention cross-platform considerations, such as authentication and context management for Linux-based runbooks.
Clarify which features and cmdlets are available or limited on Linux, and provide alternatives where possible.
Add links to documentation for creating and managing runbooks in Linux environments.
Avoid using Windows/PowerShell terminology exclusively; use neutral language where possible.

Create Pull Request

Scan History

Date	Scan	Status	Result
2026-01-13 06:17	#107	completed	Biased
2026-01-12 00:00	#99	completed	Biased
2026-01-11 06:20	#98	completed	Biased
2026-01-11 00:00	#95	cancelled	Clean
2026-01-10 00:00	#92	completed	Clean
2026-01-09 00:00	#87	cancelled	Clean
2026-01-06 22:28	#78	completed	Clean
2025-12-29 18:00	#48	cancelled	Biased
2025-12-15 00:00	#7	completed	Clean
2025-12-14 05:05	#6	completed	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