Document Details

Manage Runtime Environment
Home / Scan 41 / Manage Runtime Environment
❌
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.
GitHub View on GitHub 📚 View on Microsoft Learn

Bias Analysis

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.
GitHub 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

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