如何通过PowerShell实现Azure各类资源名称的有效性验证？

针对你遇到的Azure资源名称验证需求——尤其是Function App、App Service Plan（你提到的FunctionAppService应该是这个）、Service Bus这类没有内置PowerShell cmdlet支持自定义规则检查的资源，同时还要避免用户滥用通用名称的情况，我整理了一套实用的解决方案：

一、先明确各资源的官方命名规则 #

首先得把每个资源的官方合规规则理清楚，这是自定义验证的基础：

• Function App：1-60字符，仅允许小写字母、数字、连字符；不能以连字符开头/结尾，也不能有连续两个连字符
• App Service Plan：1-40字符，允许字母（大小写均可）、数字、连字符、下划线；不能以连字符或下划线开头/结尾
• Service Bus 命名空间：1-50字符，仅小写字母、数字、连字符；不能以连字符开头/结尾，无连续连字符
• Service Bus 实体（队列/主题等）：1-260字符，允许字母、数字、连字符、下划线、点、斜杠
• Event Hub 实体（非命名空间）：1-50字符，仅小写字母、数字、连字符；不能以连字符开头/结尾

二、自定义PowerShell验证函数 #

我写了一个通用的Test-AzureResourceName函数，既可以处理上述无内置验证的资源，也能整合你已经在用的内置cmdlet（比如Storage Account、Event Hub命名空间的验证），同时还加入了通用名称黑名单机制：

function Test-AzureResourceName {
    [CmdletBinding()]
    param(
        [Parameter(Mandatory=$true)]
        [ValidateSet('FunctionApp','AppServicePlan','ServiceBusNamespace','ServiceBusEntity','EventHub','StorageAccount','EventHubNamespace')]
        [string]$ResourceType,
        
        [Parameter(Mandatory=$true)]
        [string]$Name,
        
        # 可自定义的通用名称黑名单，按需扩展
        [string[]]$BlacklistedNames = @('test','demo','prod','default','app','service','hub','queue','topic','sb','storage')
    )

    # 第一步：检查是否属于禁用的通用名称
    if ($BlacklistedNames -contains $Name.ToLower()) {
        Write-Warning "⚠️ 名称 '$Name' 是通用名称，不建议使用，请更换更具辨识度的名称"
        return $false
    }

    # 第二步：根据资源类型应用对应的正则规则验证
    $isValid = $true
    switch ($ResourceType) {
        'FunctionApp' {
            $pattern = '^[a-z0-9](?:[a-z0-9-]{0,58}[a-z0-9])$'
            if ($Name -notmatch $pattern) {
                Write-Error "❌ Function App名称不符合规则：需1-60字符，仅小写字母、数字、连字符，不能以连字符开头/结尾，无连续连字符"
                $isValid = $false
            }
        }
        'AppServicePlan' {
            $pattern = '^[a-zA-Z0-9](?:[a-zA-Z0-9-_]{0,38}[a-zA-Z0-9])$'
            if ($Name -notmatch $pattern) {
                Write-Error "❌ App Service Plan名称不符合规则：需1-40字符，仅字母、数字、连字符、下划线，不能以连字符/下划线开头/结尾"
                $isValid = $false
            }
        }
        'ServiceBusNamespace' {
            $pattern = '^[a-z0-9](?:[a-z0-9-]{0,48}[a-z0-9])$'
            if ($Name -notmatch $pattern) {
                Write-Error "❌ Service Bus命名空间名称不符合规则：需1-50字符，仅小写字母、数字、连字符，不能以连字符开头/结尾，无连续连字符"
                $isValid = $false
            }
        }
        'ServiceBusEntity' {
            $pattern = '^[a-zA-Z0-9-_./]{1,260}$'
            if ($Name -notmatch $pattern) {
                Write-Error "❌ Service Bus实体（队列/主题）名称不符合规则：需1-260字符，仅字母、数字、连字符、下划线、点、斜杠"
                $isValid = $false
            }
        }
        'EventHub' {
            $pattern = '^[a-z0-9](?:[a-z0-9-]{0,48}[a-z0-9])$'
            if ($Name -notmatch $pattern) {
                Write-Error "❌ Event Hub实体名称不符合规则：需1-50字符，仅小写字母、数字、连字符，不能以连字符开头/结尾"
                $isValid = $false
            }
        }
    }

    # 第三步：如果有内置cmdlet可用，补充官方验证（比如Storage Account、Event Hub命名空间）
    if ($isValid) {
        switch ($ResourceType) {
            'StorageAccount' {
                $result = Get-AzureRmStorageAccountNameAvailability -Name $Name
                if (-not $result.NameAvailable) {
                    Write-Error "❌ $($result.Message)"
                    $isValid = $false
                }
            }
            'EventHubNamespace' {
                $result = Test-AzureRmEventHubName -Name $Name
                if (-not $result.NameAvailable) {
                    Write-Error "❌ $($result.Message)"
                    $isValid = $false
                }
            }
        }
    }

    # 最终返回结果
    if ($isValid) {
        Write-Host "✅ 名称 '$Name' 符合$ResourceType的命名规则" -ForegroundColor Green
        return $true
    }
    return $false
}

三、函数使用示例 #

几个常见的使用场景：

1. 验证合规的Function App名称：

Test-AzureResourceName -ResourceType FunctionApp -Name "my-retail-function-dev-01"

会输出绿色的成功提示。

2. 验证通用名称（会被拦截）：

Test-AzureResourceName -ResourceType FunctionApp -Name "test"

会弹出警告并返回false。

3. 验证Storage Account（自动调用内置cmdlet）：

Test-AzureResourceName -ResourceType StorageAccount -Name "mystorageaccount001"

会先检查黑名单，再调用Get-AzureRmStorageAccountNameAvailability验证唯一性。

四、扩展优化建议 #

• 动态维护黑名单：可以把黑名单存成JSON文件，函数启动时读取，方便团队统一维护规则。
• 结合Azure Policy：如果要在组织层面强制合规，可以把这些规则转换成Azure Policy定义，阻止不合规资源的创建。
• 添加自定义前缀/后缀规则：比如要求名称必须包含环境标识（dev/prod）或业务线代码，只需修改正则表达式即可。

内容的提问来源于stack exchange，提问作者HariHaran