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 page exhibits several Windows biases. Most code examples (Bicep, ARM template, PowerShell) are exclusively for Windows VMs, with parameters and resource types hardcoded for Windows. The PowerShell and Azure CLI sections focus on Windows extension types and do not provide Linux-specific commands or examples. The REST API section mentions both 'HybridWorkerForWindows' and 'HybridWorkerForLinux', but does not provide concrete Linux-focused examples. The removal instructions for agent-based workers do include both Windows and Linux, but the migration and extension installation steps are Windows-centric. Windows tools (PowerShell, .NET Framework) are referenced in prerequisites and examples, while Linux equivalents are either missing or mentioned briefly and without actionable guidance.
Recommendations
- Provide parallel Linux examples for Bicep, ARM template, PowerShell, and Azure CLI, including parameters and resource types for Linux VMs (e.g., 'HybridWorkerForLinux').
- Explicitly document the steps and commands for installing the extension on Linux VMs, including any required package installation and configuration.
- Include sample code for Linux VM creation and extension installation in Bicep and ARM templates.
- In PowerShell and CLI sections, show how to target Linux VMs and use 'HybridWorkerForLinux' extension type.
- List Linux prerequisites and troubleshooting steps with the same detail as Windows.
- Ensure that Linux instructions are presented with equal prominence and clarity as Windows instructions, not just as notes or afterthoughts.
Create Pull Request
Scan History
| Date | Scan | Status | Result |
|---|---|---|---|
| 2026-01-13 06:17 | #107 | completed |
Biased
|
| 2026-01-12 00:00 | #99 | completed |
Biased
|
| 2026-01-11 06:20 | #98 | completed |
Biased
|
| 2026-01-11 00:00 | #95 | cancelled |
 Clean
|
| 2026-01-10 00:00 | #92 | completed |
Clean
|
| 2026-01-09 00:00 | #87 | cancelled |
Clean
|
| 2026-01-06 22:28 | #78 | completed |
Clean
|
| 2025-12-29 18:00 | #48 | cancelled |
Clean
|
| 2025-12-15 00:00 | #7 | completed |
Clean
|
| 2025-12-14 05:05 | #6 | completed |
Clean
|