Document Details
Tutorial Configure Servers Desired State
❌
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
Bias Types:
⚠️
powershell_heavy
⚠️
windows_first
⚠️
missing_linux_example
⚠️
windows_tools
Summary:
The documentation is heavily focused on Windows and PowerShell, providing only Windows-centric examples (such as installing IIS), referencing only Windows VMs in prerequisites, and using only PowerShell cmdlets throughout. There are no Linux-specific examples, commands, or guidance, and Linux support is only briefly mentioned in passing. The documentation assumes the use of Windows tools and patterns, with no parity for Linux users.
Recommendations:
- Add Linux-specific examples, such as configuring a Linux VM with a DSC configuration (e.g., ensuring nginx or Apache is installed).
- Include Bash/CLI commands or scripts for onboarding and managing Linux nodes, not just PowerShell.
- Update prerequisites to mention Linux VMs and provide links to creating Linux VMs in Azure.
- Clarify the current support status for Linux in Azure Automation State Configuration, especially given the referenced retirement announcement.
- Provide guidance or references for managing Linux nodes, including any differences in onboarding, configuration, or compliance checking.
- Balance the documentation structure so that Linux and Windows scenarios are presented with equal prominence.
Create pull request
Scan History
| Date | Scan ID | Status | Bias Status |
|---|---|---|---|
| 2025-08-17 00:01 | #83 | in_progress | ✅ 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 |
Flagged Code Snippets
# Run a DSC check every 60 minutes
$registerAzAutomationDscNodeSplat = @{
ResourceGroupName = 'MyResourceGroup'
AutomationAccountName = 'myAutomationAccount'
AzureVMName = 'DscVm'
ConfigurationModeFrequencyMins = 60
}
Register-AzAutomationDscNode @registerAzAutomationDscNodeSplat
Connect-AzAccount
configuration TestConfig {
Node WebServer {
WindowsFeature IIS {
Ensure = 'Present'
Name = 'Web-Server'
IncludeAllSubFeature = $true
}
}
}
$registerAzAutomationDscNodeSplat = @{
ResourceGroupName = 'MyResourceGroup'
AutomationAccountName = 'myAutomationAccount'
AzureVMName = 'DscVm'
}
Register-AzAutomationDscNode @registerAzAutomationDscNodeSplat
# Get the ID of the DSC node
$getAzAutomationDscNodeSplat = @{
ResourceGroupName = 'MyResourceGroup'
AutomationAccountName = 'myAutomationAccount'
Name = 'DscVm'
}
$node = Get-AzAutomationDscNode @getAzAutomationDscNodeSplat
# Assign the node configuration to the DSC node
$setAzAutomationDscNodeSplat = @{
ResourceGroupName = 'MyResourceGroup'
AutomationAccountName = 'myAutomationAccount'
NodeConfigurationName = 'TestConfig.WebServer'
NodeId = $node.Id
}
Set-AzAutomationDscNode @setAzAutomationDscNodeSplat