通过PowerShell配置VM网络失败：IP与接口索引参数报错排查

问题现象 #

通过Invoke-VMScript从CSV读取信息批量修改虚拟机网卡IP时，出现两个错误：

New-NetIPAddress : Cannot bind argument to parameter 'IPAddress' because it is an empty string.
Set-DnsClientServerAddress : Cannot validate argument on parameter 'InterfaceIndex'. The argument is null.

单独输出外部变量（如$IP）值正常，直接在虚拟机主机执行网络命令也能成功。

核心原因 #

Invoke-VMScript的脚本块是在虚拟机内部的PowerShell上下文独立执行，外部PowerShell环境的变量默认不会自动传入VM内部的脚本块，导致VM内执行时变量为空。

解决方法 #

方法1：使用-ArgumentList传递变量（推荐） #

通过Invoke-VMScript的-ArgumentList参数将外部变量传入脚本块，在脚本块内用param定义参数接收，确保变量值正确传递到VM环境。

示例代码（结合CSV读取）：

# 读取CSV文件
$vmList = Import-Csv -Path ".\vm_ip_config.csv"

foreach ($item in $vmList) {
    # 从CSV提取配置
    $vmName = $item.VMName
    $targetIP = $item.IPAddress
    $prefix = $item.PrefixLength
    $gateway = $item.DefaultGateway
    $ifIndex = $item.InterfaceIndex
    $dnsServers = $item.DNSServers -split ","

    # 执行VM内脚本
    Invoke-VMScript -VM $vmName -ScriptBlock {
        param(
            [string]$IP,
            [int]$PrefixLength,
            [string]$Gateway,
            [int]$InterfaceIndex,
            [string[]]$DNSServers
        )

        # 先校验接口索引是否存在
        $adapter = Get-NetAdapter -InterfaceIndex $InterfaceIndex -ErrorAction Stop
        if (-not $adapter) {
            throw "Interface index $InterfaceIndex not found on this VM"
        }

        # 设置IP地址
        New-NetIPAddress -InterfaceIndex $InterfaceIndex -IPAddress $IP -PrefixLength $PrefixLength -DefaultGateway $Gateway -ErrorAction Stop
        # 设置DNS服务器
        Set-DnsClientServerAddress -InterfaceIndex $InterfaceIndex -ServerAddresses $DNSServers -ErrorAction Stop
    } -ArgumentList $targetIP, $prefix, $gateway, $ifIndex, $dnsServers -GuestCredential (Get-Credential)
}

方法2：通过字符串插值构建脚本块 #

将外部变量直接插入到脚本字符串中，再转换为scriptblock执行（注意引号转义，避免变量提前解析）：

示例：

$item = $vmList[0] # 取单条测试
Invoke-VMScript -VM $item.VMName -ScriptBlock ([scriptblock]::Create(@"
    # 调试输出变量（可选，用于确认值是否传入）
    Write-Host "IP: $($item.IPAddress), InterfaceIndex: $($item.InterfaceIndex)"

    # 修改网络配置
    New-NetIPAddress -InterfaceIndex $($item.InterfaceIndex) -IPAddress "$($item.IPAddress)" -PrefixLength $($item.PrefixLength) -DefaultGateway "$($item.DefaultGateway)"
    Set-DnsClientServerAddress -InterfaceIndex $($item.InterfaceIndex) -ServerAddresses $($item.DNSServers -split ',')
"@)) -GuestCredential (Get-Credential)

额外注意事项 #

• 确保-GuestCredential的账号拥有虚拟机内修改网络设置的权限（如本地管理员）。
• 执行前可在目标虚拟机内手动运行Get-NetAdapter，确认InterfaceIndex的有效性，避免索引错误。
• 可在脚本块中加入Write-Host输出变量值，通过Invoke-VMScript的返回结果查看，验证变量是否正确传入VM环境。

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