使用PowerShell查询Azure VM标签值时缺失问题求助

问题描述 #

使用PowerShell 7+最新AZ模块导出Azure虚拟机标签到CSV文件时，近半数资源的标签值显示为空，但Azure WebUI中明确存在这些标签。无论筛选特定标签键（如Technical POC）还是导出全部标签，均出现部分成功、部分失败的情况。

示例代码与输出 #

筛选特定标签键的示例代码 #

# 筛选特定标签键的示例代码
$tagKey = "Technical POC"  # 替换为你要获取的标签键
if ($tags.ContainsKey($tagKey)) {
    Write-Warning "The value of the tag '$tagKey' is: $($tags[$tagKey])"
}

# 格式化输出到CSV的示例代码
$vmdetail = [PSCustomObject]@{
     SubscriptionId    = $subscription.Id
     SubscriptionName  = $subscription.Name
     ResourceGroupName = $VMResource.ResourceGroupName
     VMName            = $VMResource.Name
     TechnicalPOC      = $($tags[$tagKey])
}

输出示例 #

失败案例（WebUI有标签但输出为空）

WARNING: testvm1
WARNING: Getting VM Tags
WARNING: Tags Recieved
WARNING: The value of the tag 'Technical POC' is: 

成功案例1：无标签

WARNING: testvm2
WARNING: Getting VM Tags
WARNING: Tags Recieved
WARNING: Tag 'Technical POC' not found on the VM.

成功案例2：有标签

WARNING: testvm3
WARNING: Getting VM Tags
WARNING: Tags Recieved
WARNING: The value of the tag 'Technical POC' is: john.smith@domain.com

可能原因 #

• 标签键大小写敏感：Azure标签键区分大小写，WebUI显示的键可能与PowerShell获取的键大小写不一致
• 标签继承问题：VM标签可能从资源组/订阅继承，默认Get-AzVM仅返回VM自身的标签，不包含继承标签
• 标签值含空白字符：标签值可能包含不可见空白（如空格、制表符），导致输出看似为空
• 权限不足：当前账号对部分VM的标签无读取权限

解决方案 #

1. 统一标签键大小写匹配 #

修改代码，使用不区分大小写的方式查找标签键：

$tagKey = "Technical POC"
# 不区分大小写匹配标签键
$matchingKey = $tags.Keys | Where-Object { $_ -ieq $tagKey }
if ($matchingKey) {
    $technicalPOCValue = $tags[$matchingKey].Trim()
    Write-Warning "The value of the tag '$tagKey' is: $technicalPOCValue"
} else {
    $technicalPOCValue = $null
    Write-Warning "Tag '$tagKey' not found on the VM."
}

$vmdetail = [PSCustomObject]@{
     SubscriptionId    = $subscription.Id
     SubscriptionName  = $subscription.Name
     ResourceGroupName = $VMResource.ResourceGroupName
     VMName            = $VMResource.Name
     TechnicalPOC      = $technicalPOCValue
}

2. 获取包含继承标签的VM信息 #

使用Get-AzResource替代Get-AzVM，该命令会返回包含资源组/订阅继承标签的完整资源数据：

# 获取所有VM资源（含继承标签）
$vms = Get-AzResource -ResourceType "Microsoft.Compute/virtualMachines"

foreach ($vm in $vms) {
    $subscription = Get-AzSubscription -SubscriptionId $vm.SubscriptionId
    $tags = $vm.Tags
    $tagKey = "Technical POC"
    # 处理标签值，空值时标记为"未找到标签"
    $technicalPOCValue = if ($tags.Keys -ieq $tagKey) {
        $tags[$tags.Keys | Where-Object { $_ -ieq $tagKey }].Trim()
    } else {
        "未找到标签"
    }

    [PSCustomObject]@{
         SubscriptionId    = $subscription.Id
         SubscriptionName  = $subscription.Name
         ResourceGroupName = $vm.ResourceGroupName
         VMName            = $vm.Name
         TechnicalPOC      = $technicalPOCValue
    } | Export-Csv -Path "VM_Tags.csv" -Append -NoTypeInformation -Encoding UTF8
}

3. 清理标签值空白字符 #

如果标签值存在不可见空白，添加Trim()方法去除首尾空白：

$technicalPOCValue = $tags.ContainsKey($tagKey) ? $tags[$tagKey].Trim() : $null

4. 验证权限 #

确保当前账号拥有Microsoft.Compute/virtualMachines/read和Microsoft.Resources/tags/read权限，可通过Azure RBAC角色（如读者）授予必要权限。

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