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_first
⚠️
missing_linux_example
⚠️
windows_tools
Summary:
The documentation is heavily biased toward Windows environments. All examples use Windows-specific tools (PowerShell, WinGet), and there is no mention of Linux or cross-platform alternatives. The schema and task definitions assume PowerShell as the scripting environment, and all sample commands and built-in tasks are Windows-centric. There are no examples or guidance for Linux users or for using Bash, shell scripts, or Linux package managers.
Recommendations:
- Add examples using Bash or shell scripts for task definitions, alongside PowerShell.
- Document support (or lack thereof) for Linux-based dev boxes, and clarify if only Windows is supported.
- If Linux is supported, provide equivalent built-in tasks for Bash and Linux package managers (e.g., apt, yum, dnf).
- Include Linux image examples in the image attribute section.
- Explicitly state OS compatibility for each built-in task and provide parity where possible.
- Where only Windows is supported, clearly call this out to set expectations for cross-platform users.
Create pull request
Flagged Code Snippets
$schema: 1.0
name: project-sample-1
image: MicrosoftWindowsDesktop_windows-ent-cpc_win11-21h2-ent-cpc-m365
tasks:
- name: "powershell"
inputs:
command:
image: MicrosoftWindowsDesktop_windows-ent-cpc_win11-21h2-ent-cpc-m365
tasks:
- name: winget
parameters:
package: GitHub.GitHubDesktop
tasks:
- name: powershell
timeout: 1800 # in seconds
parameters:
command: <command>
name: powershell
description: Execute a powershell command
author: Microsoft Corporation
command: ".\runcommand.ps1 -command {{command}} -workingDirectory {{workingDirectory}}"
inputs:
command:
type: string
defaultValue: ""
required: true
description: The command to execute
workingDirectory:
type: string
defaultValue: ""
required: false
description: The working directory to execute the command in
description: This task executes a powershell command
command: ".\runcommand.ps1
command: ".\runcommand.ps1 -command {{command}} -workingDirectory {{workingDirectory}}"