Azure PowerShell创建NIC报错排查：子网引用无效及绑定失败

1. 验证子网资源是否真实存在 #

直接执行PowerShell命令查询目标虚拟网络下的子网，确认是否存在名称完全匹配的子网：

Get-AzVirtualNetworkSubnetConfig -VirtualNetwork (Get-AzVirtualNetwork -Name $targetVNET -ResourceGroupName $resourceGroup)

• 注意大小写敏感：Azure资源名称在部分场景下区分大小写，需确认报错中的Target_subnet1与你定义的$targetSubnetName是否完全一致（包括大小写）。
• 确认虚拟网络和子网确实在指定的$resourceGroup资源组下，不存在跨资源组的情况。

2. 检查subnetId变量拼接是否正确 #

手动输出$subnetId变量的值，对比实际子网的资源ID：

Write-Output $subnetId

再通过命令获取子网的真实资源ID：

(Get-AzVirtualNetworkSubnetConfig -Name $targetSubnetName -VirtualNetwork (Get-AzVirtualNetwork -Name $targetVNET -ResourceGroupName $resourceGroup)).Id

对比两者是否完全一致，重点排查：

• $subscriptionId、$resourceGroup、$targetVNET、$targetSubnetName变量是否正确赋值，有无拼写错误或空值。
• 资源ID格式是否正确，变量拼接时是否混入多余符号。

3. 确认资源区域一致性 #

检查子网所属虚拟网络与要创建的NIC的区域是否完全一致：

# 获取虚拟网络的区域
(Get-AzVirtualNetwork -Name $targetVNET -ResourceGroupName $resourceGroup).Location
# 检查当前使用的$location变量值
Write-Output $location

Azure要求关联的网络资源必须处于同一区域，即使资源名称相同但区域不同也会触发报错。

4. 修正NIC绑定命令的错误 #

即使NIC创建成功，当前的Add-AzVMNetworkInterface命令也存在参数错误：-ID需要传入NIC的资源ID而非NIC对象，正确写法为：

Add-AzVMNetworkInterface -VM $newVM -Id $newNic.Id

若NIC创建失败，$newNic会是空值，自然会报Id参数为空的错误，需优先解决前面的子网存在性问题。

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