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 demonstrates a notable Windows bias. Most code examples (Bicep, ARM template, PowerShell) focus exclusively on Windows VMs, with parameters and resource types hardcoded for Windows (e.g., 'HybridWorkerForWindows'). PowerShell is emphasized as the primary automation tool, with Windows-specific prerequisites and folder paths detailed, while Linux equivalents are either missing or less detailed. Linux-specific instructions, examples, and extension types (e.g., 'HybridWorkerForLinux') are not provided in the main migration and deployment sections, making it harder for Linux users to follow along.
Recommendations
- Add parallel Linux-focused examples for Bicep, ARM templates, REST API, Azure CLI, and PowerShell, including use of 'HybridWorkerForLinux' extension type.
- Include Linux VM creation and onboarding steps in all code samples, not just Windows.
- Document Linux-specific prerequisites, folder paths, and permissions with the same level of detail as Windows.
- Ensure that CLI and PowerShell examples show both Windows and Linux usage, or provide tabs for each.
- Clarify any differences in extension installation or management between Windows and Linux.
- Review and update references to Windows-only tools (e.g., PowerShell 5.1) and provide Linux alternatives (e.g., PowerShell Core, Bash).
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
|