Manage Clusters Runbooks - Document Details

About This Page

This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.

View on GitHub 📚 View on Microsoft Learn

Bias Analysis

Detected Bias Types

powershell_heavy

windows_first

missing_linux_example

windows_tools

Summary

The documentation exclusively uses PowerShell for all scripting and automation examples, with no mention of alternatives such as Python or Bash. All runbook examples, module installations, and code snippets are PowerShell-based, and the workflow assumes familiarity with Windows-centric tools and patterns. There are no Linux-native scripting examples or references to cross-platform automation options, and the 'Next step' also points to a PowerShell-specific guide.

Recommendations

Provide equivalent examples using Python runbooks (supported in Azure Automation) for creating and deleting HDInsight clusters.
Include Bash/CLI examples where possible, especially for users who may prefer Linux-native scripting.
Mention and link to Azure CLI and REST API documentation as alternative, cross-platform ways to automate HDInsight cluster management.
Balance the order of presentation so that PowerShell and Linux-friendly options are introduced together, or alternate which is presented first.
Clarify that PowerShell runbooks can be authored and executed from non-Windows platforms using PowerShell Core, and provide guidance for Linux/macOS users.

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	Clean
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-09-06 00:00	#103	completed	Clean
2025-08-17 00:01	#83	cancelled	Clean
2025-07-13 21:37	#48	completed	Biased
2025-07-12 23:44	#41	cancelled	Biased
2025-07-09 13:09	#3	cancelled	Clean
2025-07-08 04:23	#2	cancelled	Biased

Flagged Code Snippets

    Param
    (
      [Parameter (Mandatory= $true)]
      [String] $clusterName
    )
    
    ### Authenticate to Azure 
    $Conn = Get-AutomationConnection -Name 'AzureRunAsConnection'
    Add-AzureRMAccount -ServicePrincipal -Tenant $Conn.TenantID -ApplicationId $Conn.ApplicationID -CertificateThumbprint $Conn.CertificateThumbprint
    
    Remove-AzureRmHDInsightCluster -ClusterName $clusterName