Remove-ArcEnabledServersByOsName.ps1

Remove-AzureArcEnabledServersByOsName.ps1

# Parameters
[CmdletBinding(SupportsShouldProcess)]
param (
    [Parameter(Mandatory = $true)]
    [string] $ResourceGroupName,
    [Parameter()]
    [string] $OsName = "linux"
)

# Get all Azure Arc enabled servers in the resource group
$arcMachines = Get-AzResource -ResourceGroupName $ResourceGroupName | Where-Object { $_.Type -eq "Microsoft.HybridCompute/machines" }

# Review all Azure Arc-enabled servers
foreach ($arcMachine in $arcMachines) {
    $ResourceId = $arcMachine.ResourceId
    
    # Retrieve the properties of each server
    $ResourceProperties = (Get-AzResource -ResourceId $ResourceId -ExpandProperties).Properties

    # If the OS matches the OS to be deleted
    if ($ResourceProperties.OsName.ToLower() -eq $OsName) {
        Write-Output "Removing resource $($arcMachine.Name)"
        # Delete that server from Azure
        # Note: This will not remove the agent or any extensions from the OS
        Remove-AzResource -ResourceId $ResourceId -Force -WhatIf:$WhatIfPreference
    }
}