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 ways: Windows is consistently presented first in OS support tables and examples; Bicep and ARM template samples are exclusively for Windows VMs, with no Linux equivalents; PowerShell is used heavily for management and migration tasks, while Linux-specific CLI or scripting examples are sparse or absent; and Windows-specific tools and requirements (e.g., Windows PowerShell, .NET Framework, registry edits) are detailed, whereas Linux requirements and procedures are less comprehensive or relegated to notes.
Recommendations
- Provide Bicep and ARM template examples for deploying and managing Linux VMs as Hybrid Workers, including the correct extension type (HybridWorkerForLinux).
- Ensure Linux is presented equally or first in tables, examples, and step-by-step instructions where relevant.
- Include Linux-specific CLI and scripting examples (e.g., Bash scripts, cloud-init, Ansible) for migration and management tasks.
- Expand on Linux requirements and troubleshooting steps to match the detail given for Windows (e.g., folder permissions, extension settings).
- Balance PowerShell usage with equivalent Linux-native tooling (e.g., Azure CLI, REST API, Bash) in all management scenarios.
- Explicitly mention Linux-specific extension types and settings in all relevant code samples and API payloads.
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
|