Document Details
Onboard Update Management Machines
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
missing_linux_example
Summary
The documentation describes onboarding both Windows and Linux machines to Azure Arc via Automation Update Management, but operational details and examples are Windows-centric. Runbook names and references (e.g., Add-UMMachinesToArc, Add-UMMachinesToArcWindowsChild) use PowerShell-style naming conventions, and instructions for monitoring and troubleshooting refer to Azure PowerShell and Windows-first workflows. There are no explicit Linux command-line examples or references to Linux-native tools, and the documentation does not provide parity in Linux-specific guidance.
Recommendations
- Include explicit Linux command-line examples (e.g., Bash, shell scripts) for onboarding and verification steps.
- Reference Linux-native tools (such as CLI commands, systemd, journalctl) alongside or before Windows equivalents.
- Provide screenshots or walkthroughs from Linux environments in addition to Windows/Azure portal views.
- Clarify that runbooks and automation workflows support both PowerShell and Bash, and provide sample scripts for each.
- Ensure troubleshooting and verification steps include Linux-specific guidance (e.g., checking agent status via systemctl, reviewing logs in /var/log).
Create Pull Request