Document Details
Migrate Existing Agent Based Hybrid Worker To Extension Based Workers
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.
Bias Analysis
Detected Bias Types
windows_first
missing_linux_example
powershell_heavy
windows_tools
Summary
The documentation demonstrates a Windows bias in several key areas. Examples and templates for Bicep and ARM are exclusively for Windows VMs, with no Linux equivalents provided. PowerShell is heavily featured, and Windows-specific tools and patterns (such as Windows PowerShell 5.1, .NET Framework, and registry editing) are mentioned and used before or instead of Linux alternatives. Linux instructions are minimal, often limited to brief bash commands, and lack parity with the detailed Windows steps and scripts.
Recommendations
- Provide equivalent Bicep and ARM template examples for Linux VMs, including supported OS images and extension types.
- Include detailed Linux CLI and scripting examples (e.g., bash, cloud-init, Ansible) for installing and managing Hybrid Worker extensions.
- Expand Linux prerequisites and troubleshooting sections to match the depth of Windows coverage.
- List Linux requirements and steps alongside Windows, not after or separately, to ensure equal visibility.
- Offer PowerShell Core examples for Linux where applicable, and clarify cross-platform cmdlet support.
- Ensure all extension installation instructions (REST API, Azure CLI, PowerShell) explicitly show both Windows and Linux extension types and settings.
Create Pull Request
Scan History
| Date | Scan | Status | Result |
|---|---|---|---|
| 2026-01-14 00:00 | #250 | in_progress |
Biased
|
| 2026-01-13 00:00 | #246 | completed |
Biased
|
| 2026-01-12 00:00 | #243 | cancelled |
Biased
|
| 2026-01-11 00:00 | #240 | completed |
Biased
|
| 2026-01-10 00:00 | #237 | completed |
Biased
|
| 2026-01-09 00:34 | #234 | completed |
Biased
|
| 2026-01-08 00:53 | #231 | completed |
 Clean
|
| 2026-01-06 18:15 | #225 | cancelled |
Clean
|
| 2025-08-17 00:01 | #83 | cancelled |
Clean
|
| 2025-07-13 21:37 | #48 | completed |
Biased
|
| 2025-07-09 13:09 | #3 | cancelled |
Clean
|
| 2025-07-08 04:23 | #2 | cancelled |
Biased
|