Azure中为NIC添加额外私有IP时出现PowerShell执行报错

你遇到的参数绑定错误是核心问题，根源如下：

• 直接触发报错的原因：New-AzNetworkInterfaceIpConfig 仅用于生成独立的IP配置对象，不接受管道传入的网络接口卡（NIC）对象作为输入。你将获取到的现有NIC $Nic 通过管道传给该cmdlet，命令无法将输入对象匹配到可绑定的参数，因此直接抛出错误。
• 脚本中还存在两个会导致后续执行失败的隐藏问题：
  • IP配置重名：你给两个新增IP配置都命名为ipconfig2，Azure不允许同一NIC下的IP配置名称重复，即使参数绑定问题解决也会报重名错误。
  • 配置逻辑错误：New-AzNetworkInterfaceIpConfig 不会直接把生成的IP配置附加到现有NIC上，你之前的管道写法完全没有将新生成的配置和NIC关联，就算命令执行成功，最终更新NIC时也不会生效，甚至会覆盖原有NIC上已有的默认IP配置，导致关联的虚拟机断网。

按照下面的流程执行，可在保留NIC原有配置的前提下追加多个静态私有IP：

1. 前置初始化逻辑（这部分和你原有脚本的逻辑一致，无修改）：

# 切换到目标订阅
Set-AzContext -Subscription "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

# 获取目标虚拟网络和子网配置
$vnet = Get-AzVirtualNetwork -Name "rosvnet" -ResourceGroupName "sample"
$subnet = Get-AzVirtualNetworkSubnetConfig -Name "default" -VirtualNetwork $vnet

# 获取待修改的现有NIC
$nic = Get-AzNetworkInterface -ResourceGroupName "sample" -Name "closer-nic"

2. 保留原有NIC的IP配置，避免被新配置覆盖：

# 将NIC现有的IP配置存入数组，后续追加新配置时直接操作该数组
$ipConfigList = @($nic.IpConfigurations)

3. 生成每个新增私有IP的配置，确保配置名称全局唯一，追加到配置数组中：

# 追加10.1.0.11的配置，名称设为ipconfig1
$ipConfigList += New-AzNetworkInterfaceIpConfig -Name "ipconfig1" -PrivateIpAddress "10.1.0.11" -Subnet $subnet
# 追加10.1.0.13的配置，名称设为ipconfig2
$ipConfigList += New-AzNetworkInterfaceIpConfig -Name "ipconfig2" -PrivateIpAddress "10.1.0.13" -Subnet $subnet
# 追加10.1.0.14的配置，名称设为ipconfig3（避免和之前的ipconfig2重名）
$ipConfigList += New-AzNetworkInterfaceIpConfig -Name "ipconfig3" -PrivateIpAddress "10.1.0.14" -Subnet $subnet

4. 将更新后的配置数组写回NIC对象，执行最终更新：

# 将合并后的配置数组赋值给NIC的IP配置属性
$nic.IpConfigurations = $ipConfigList
# 调用Set-AzNetworkInterface让配置正式生效
$nic | Set-AzNetworkInterface

• 同一NIC下的所有IP配置名称必须唯一，否则会触发校验错误。
• 如果不需要指定静态私有IP，可去掉-PrivateIpAddress参数，Azure会自动从子网可用地址池中分配动态私有IP。
• 执行前请确认目标私有IP未被同子网下的其他Azure资源占用，否则会报IP地址冲突错误。
• 不要直接用新生成的配置覆盖$nic.IpConfigurations，否则会删除NIC原有的主IP配置，导致关联的虚拟机网络中断。

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