Azure服务标签JSON与Get-AzLocation区域名称不匹配的自动化适配问题

核心结论 #

你没选错获取途径：Azure DevOps托管代理的IP确实不在Get-AzNetworkServiceTag的返回结果里，使用官方发布的Service Tags JSON文件是正确的做法。区域名称不匹配是因为JSON文件使用的是旧版区域代码/缩写，而Get-AzLocation返回的是标准化的区域名称，解决这个问题最可靠的方式是构建区域名称映射表。

具体解决方案 #

1. 手动构建区域映射字典

整理所有不匹配的区域对应关系，在脚本中加入转换逻辑。比如创建PowerShell哈希表存储映射：

# 区域名称映射：Key = Get-AzLocation返回的名称，Value = Service Tags JSON中的名称
$regionNameMap = @{
    "germanywestcentral" = "germanywc"
    "germanynorth"       = "germanyn"
    "francecentral"      = "centralfrance"
    "francesouth"        = "southfrance"
    # 可根据实际遇到的不匹配项补充
}

# 使用示例：将Get-AzLocation获取的区域转换为JSON中对应的名称
$targetRegions = Get-AzLocation | Where-Object {$_.DisplayName -match "Europe"} | Select-Object -ExpandProperty Name

$convertedRegions = $targetRegions | ForEach-Object {
    if ($regionNameMap.ContainsKey($_)) {
        $regionNameMap[$_]
    }
    else {
        $_ # 名称一致的区域直接保留
    }
}

这个方法的优势是准确、性能高，适合已知所有差异的场景。

2. 动态匹配补充（可选）

如果担心遗漏某些边缘区域的映射，可以在脚本中增加模糊匹配逻辑作为 fallback。比如通过关键词匹配：

function Convert-RegionName {
    param(
        [string]$LocationName,
        [array]$ServiceTagRegions
    )

    # 先查静态映射
    if ($regionNameMap.ContainsKey($LocationName)) {
        return $regionNameMap[$LocationName]
    }

    # 模糊匹配：拆分关键词查找
    $keywords = $LocationName -split "(?<=[a-z])(?=[A-Z])" # 驼峰拆分，比如francecentral拆为france、central
    $match = $ServiceTagRegions | Where-Object {
        $_ -match $keywords[0] -and $_ -match $keywords[1]
    }

    return $match -join "," # 若多个匹配可做额外处理，通常只会有一个
}

使用时先从Service Tags JSON中提取所有区域列表，再传入这个函数做转换。

注意事项 #

• 微软偶尔会新增区域或调整区域代码，建议定期检查Service Tags JSON和Get-AzLocation的返回结果，更新映射表。
• 测试时可以打印转换后的区域列表，验证是否能在Service Tags JSON中找到对应的条目，避免出现遗漏。

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