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
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation page exhibits a Windows bias in several areas. Windows examples, tools, and terminology are presented first or exclusively in key sections, especially in the Bicep and ARM template samples, which only provision Windows VMs. PowerShell is heavily featured, with detailed cmdlets and usage, while Linux equivalents are minimal or absent. The extension installation examples and resource definitions focus on Windows-specific handlers (HybridWorkerForWindows), and Linux-specific instructions are either missing or relegated to notes or optional sections. The removal process for agent-based workers is more detailed for Windows (registry manipulation) than for Linux (simple directory removal), and permissions guidance is Windows-centric.
Recommendations
- Provide parallel Bicep and ARM template examples for Linux VMs, using the correct image references and extension types (HybridWorkerForLinux).
- Include Linux-specific CLI and PowerShell commands, such as az vm create with Linux images and Set-AzVMExtension/New-AzConnectedMachineExtension using HybridWorkerForLinux.
- Expand Linux prerequisites and troubleshooting sections to match the depth given to Windows, including permissions, identity, and hardening guidance.
- Ensure all extension installation examples clearly show both Windows and Linux type values and settings.
- Balance the order of presentation so that Linux instructions/examples are given equal prominence and detail as Windows.
- Add more Linux-specific automation and management scenarios, including common distributions and shell scripting examples.
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
|