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
⚠️
windows_first
⚠️
missing_linux_example
Summary:
The documentation demonstrates a clear bias towards Windows and PowerShell environments. Most examples, especially for creating and managing runbooks and runtime environments, focus on PowerShell, with detailed steps and REST API payloads referencing PowerShell modules (e.g., Az PowerShell, Get-Module). Windows/PowerShell-specific packaging (.zip, PowerShell Gallery) is emphasized, while Linux/Python equivalents are only briefly mentioned or relegated to notes. There are no concrete Linux shell or Python-centric examples, and Windows tools and conventions are referenced before or instead of Linux alternatives.
Recommendations:
- Provide equivalent, detailed examples for Python runbooks, including REST API payloads and portal workflows.
- Include explicit Linux/Python packaging instructions and examples (e.g., using .whl files, pip, or Linux shell commands) alongside PowerShell/Windows instructions.
- Balance the documentation by presenting Python/Linux options before or alongside PowerShell/Windows options, rather than as afterthoughts or notes.
- Add screenshots and walkthroughs for Python runbooks and Linux-based runtime environments, not just PowerShell.
- Reference Linux/Python package repositories (e.g., PyPI) and tools (e.g., pip) where appropriate, not just PowerShell Gallery.
- Clarify when instructions or features are platform-specific, and provide parity where possible.
Create pull request
Flagged Code Snippets
PATCH
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runbooks/<runbookName>?api-version=2024-10-23
{
"properties": {
"type": "PowerShell"
"runtimeEnvironment": "<runtimeEnvironmentName>"
}
}
PUT
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runtimeEnvironments/<runtimeEnvironmentName>?api-version=2024-10-23
{
"properties": {
"runtime": {
"language": "PowerShell",
"version": "7.4"
},
"defaultPackages": {
"Az": "12.3.0"
}
},
"name": "<runtimeEnvironmentName>"
}
PUT
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runtimeEnvironments/<runtimeEnvironmentName>/packages/Az.Accounts?api-version=2024-10-23
{
"properties": {
"contentLink": {
"uri": "https://psg-prod-eastus.azureedge.net/packages/az.accounts.2.12.4.nupkg"
}
}
}
PUT
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runbooks/<runbookName>?api-version=2024-10-23
{
"properties": {
"runbookType": "PowerShell",
"runtimeEnvironment": <runtimeEnvironmentName>,
"publishContentLink": {
"uri": "https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/101-automation-runbook-getvms/Runbooks/Get-AzureVMTutorial.ps1"
}
},
"location": "East US"
}