Azure Windows Server虚拟机获取网卡别名添加Secondary IP方法

问题描述 #

我在Azure中有多台Windows Server虚拟机，需要在Guest OS中临时添加Secondary IP。这些虚拟机由ASR生成，已知Primary IP，但不清楚对应NIC的Interface Alias。计划用命令New-NetIPAddress -IPAddress xxx.xxx.xxx.xxx -InterfaceAlias "NAME" -SkipAsSource $true添加，想知道如何获取该NIC的Interface Alias并应用，或者有没有其他解决方案。当前代码如下：

$PrimaryIP = "10.20.30.5"
$NetworkInterface = Get-NetIPConfiguration | Where-Object { $_.IPv4Address.IPAddress -eq $PrimaryIP }

$InterfaceAlias = $NetworkInterface.InterfaceAlias

$SecondaryIP = "10.20.30.6"  
New-NetIPAddress -IPAddress $SecondaryIP -InterfaceAlias $InterfaceAlias -PrefixLength 24 -SkipAsSource $false

Start-Sleep -Seconds 60

New-NetRoute -DestinationPrefix 0.0.0.0/0 -InterfaceAlias $InterfaceAlias -NextHop 10.20.30.1

解决方案 #

一、现有代码的优化与验证 #

你的现有代码核心逻辑是成立的——通过Primary IP定位对应网络配置、提取Interface Alias，再执行添加操作。但有几个细节需要调整，让脚本更健壮：

• SkipAsSource参数：临时Secondary IP建议设为$true，避免该IP被优先用作出站源IP（除非你明确需要它作为默认出站地址）
• 路由添加必要性：如果Secondary IP和Primary IP在同一子网，通常无需额外添加默认路由，可根据需求注释该步骤
• 错误处理：增加判断逻辑，避免找不到对应IP时脚本直接报错

优化后的代码：

$PrimaryIP = "10.20.30.5"
$SecondaryIP = "10.20.30.6"
$NextHop = "10.20.30.1"
$PrefixLength = 24

# 获取绑定Primary IP的网络配置
$NetworkInterface = Get-NetIPConfiguration | Where-Object { 
    $_.IPv4Address -and $_.IPv4Address.IPAddress -eq $PrimaryIP 
}

if ($NetworkInterface) {
    $InterfaceAlias = $NetworkInterface.InterfaceAlias
    Write-Host "找到对应Interface Alias: $InterfaceAlias"

    # 添加Secondary IP，临时IP推荐设置SkipAsSource为true
    New-NetIPAddress -IPAddress $SecondaryIP -InterfaceAlias $InterfaceAlias -PrefixLength $PrefixLength -SkipAsSource $true

    # 同一子网下可注释该行，仅特殊路由需求时启用
    # New-NetRoute -DestinationPrefix 0.0.0.0/0 -InterfaceAlias $InterfaceAlias -NextHop $NextHop
} else {
    Write-Error "未找到绑定Primary IP $PrimaryIP的网络接口"
}

二、其他获取Interface Alias的方法 #

如果现有命令执行异常，可尝试以下两种更可靠的方式：

1. 通过Azure元数据服务（ASR虚拟机首选）

ASR生成的虚拟机可通过Azure实例元数据服务直接获取NIC的MAC地址，再映射到Guest OS的Interface Alias，避免Guest OS内部IP配置异常导致的匹配失败：

# 从元数据获取绑定Primary IP的NIC MAC地址
$metadata = Invoke-RestMethod -Uri "http://169.254.169.254/metadata/instance/network/interface?api-version=2021-02-01" -Headers @{"Metadata"="true"}
$primaryNic = $metadata | Where-Object { $_.ipv4.ipAddress.ipAddress -eq $PrimaryIP }
$macAddress = $primaryNic.macAddress -replace ":","-"

# 通过MAC地址定位Interface Alias
$InterfaceAlias = (Get-NetAdapter | Where-Object { $_.MacAddress -eq $macAddress }).Name

Write-Host "通过元数据获取的Interface Alias: $InterfaceAlias"

2. 直接通过IP地址定位网卡

跳过Get-NetIPConfiguration，直接用Get-NetIPAddress提取Interface Alias：

$InterfaceAlias = (Get-NetIPAddress -IPAddress $PrimaryIP).InterfaceAlias

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