如何在Azure REST API的PowerShell请求中正确使用变量

错误原因 #

你遇到的问题是PowerShell在双引号字符串中解析复杂对象属性时的语法问题。直接写$RG_List.value.name[0]时，PowerShell只会解析$RG_List这个变量，后面的.value.name[0]会被当作普通字符串拼接，导致URL中出现无效的资源组名称@{value=System.Object[]}.value.name[0]，触发ResourceGroupNotFound错误。

正确写法 #

需要用**子表达式$()**包裹复杂的属性访问表达式，让PowerShell先执行表达式并返回结果，再插入到URL字符串中：

$RG_List = Invoke-RestMethod 'https://management.azure.com/subscriptions/my_subscription_id/resourcegroups?api-version=2021-04-01' -Method 'GET' -Headers $headers

# 先提取第一个资源组名称到变量，再插入URL
$firstRGName = $RG_List.value.name[0]
$RG_VM = Invoke-RestMethod "https://management.azure.com/subscriptions/my_subscription_id/resourceGroups/$($firstRGName)/providers/Microsoft.Compute/virtualMachines?api-version=2022-11-01" -Method 'GET' -Headers $headers

或者直接在URL中嵌套子表达式：

$RG_VM = Invoke-RestMethod "https://management.azure.com/subscriptions/my_subscription_id/resourceGroups/$($RG_List.value.name[0])/providers/Microsoft.Compute/virtualMachines?api-version=2022-11-01" -Method 'GET' -Headers $headers

额外建议 #

为避免因资源组列表为空导致的错误，建议先判断是否存在资源组：

if ($RG_List.value -and $RG_List.value.Count -gt 0) {
    $firstRGName = $RG_List.value.name[0]
    $RG_VM = Invoke-RestMethod "https://management.azure.com/subscriptions/my_subscription_id/resourceGroups/$($firstRGName)/providers/Microsoft.Compute/virtualMachines?api-version=2022-11-01" -Method 'GET' -Headers $headers
} else {
    Write-Warning "当前订阅下没有资源组"
}

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