Manage Runtime Environment - 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

windows_first

missing_linux_example

Summary

The documentation page demonstrates a clear bias towards Windows and PowerShell environments. PowerShell is the primary scripting language discussed, with detailed examples and default package support. Windows/PowerShell-specific tools and patterns (such as PowerShell Gallery, Az PowerShell module, and Get-Module cmdlet) are mentioned and exemplified, while Linux or cross-platform alternatives are either referenced only in passing or omitted. Python (the main cross-platform alternative) is mentioned, but with far less detail, and there are no concrete Linux shell or CLI examples. The documentation assumes familiarity with Windows-centric workflows and tools, and Linux-specific guidance is minimal or missing.

Recommendations

Provide equivalent Linux/bash examples for all operations, especially where PowerShell commands or modules are shown.
Include examples using Azure CLI (az) in bash, not just PowerShell, and clarify cross-platform compatibility.
When referencing package uploads, give equal detail for Python (.whl) and Linux-specific packaging, not just PowerShell modules.
Mention and demonstrate how to manage and inspect Python packages (e.g., using pip or python -m pip list) in runbooks, similar to the Get-Module example for PowerShell.
Clarify which features and packages are available or behave differently on Linux-based runtime environments.
Avoid defaulting to PowerShell/Windows terminology (e.g., 'PowerShell Gallery') without also referencing PyPI or other Linux-friendly sources.
Explicitly state when examples are Windows/PowerShell-specific and provide parallel Linux/Python instructions where possible.

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

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>/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"
}

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" 
    } 
  } 
}

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>" 
  } 
}