保姆级教程：在Windows 10上用PowerShell为ESXi 6.7 U3集成RTL8125网卡驱动（含避坑指南）

保姆级教程：在Windows 10上用PowerShell为ESXi 6.7 U3集成RTL8125网卡驱动（含避坑指南）

对于家庭实验室用户和小型企业运维人员来说，在Windows环境下为ESXi 6.7 U3离线安装包集成第三方网卡驱动是一个常见需求。本文将详细介绍如何使用PowerShell工具链完成这一任务，特别针对RTL8125网卡驱动集成过程中可能遇到的各种问题提供解决方案。

1. 环境准备与工具下载

在开始之前，我们需要准备好所有必要的工具和文件。以下是完整的准备工作清单：

• Windows 10系统：确保系统已更新至最新版本
• PowerShell 5.1或更高版本（Windows 10默认安装）
• VMware PowerCLI模块：用于与ESXi交互
• ESXi-Customizer-PS脚本：v2.6.0版本
• ESXi 6.7 U3离线安装包：官方下载的zip格式
• RTL8125网卡驱动：Realtek_bootbank_net-r8125_9.007.01-1.vib

提示：所有工具和驱动建议从官方渠道下载，避免使用第三方修改版本可能带来的安全隐患。

1.1 安装VMware PowerCLI模块

首先需要安装VMware PowerCLI模块，这是后续操作的基础。以管理员身份运行PowerShell，执行以下命令：

Install-Module -Name VMware.PowerCLI -Force -AllowClobber

安装过程中可能会遇到以下提示：

1. 关于不受信任存储库的警告
2. 版本冲突提示（如果系统已安装旧版PowerCLI）

对于第一个提示，输入Y确认继续安装。对于版本冲突，添加-Force参数可以同时保留多个版本。

1.2 修改PowerShell执行策略

默认情况下，PowerShell的执行策略会阻止脚本运行。我们需要临时修改执行策略：

Set-ExecutionPolicy -ExecutionPolicy Unrestricted -Scope Process -Force

注意：这只会影响当前PowerShell会话，关闭后会自动恢复默认设置，比永久修改更安全。

2. 文件目录组织

合理的文件目录结构可以避免很多路径相关的问题。建议按照以下结构组织文件：

ESXi_RTL8125_Integration/ │ ├── ESXi-Customizer-PS-v2.6.0.ps1 ├── ESXi670-202210001.zip │ └── drivers/ └── Realtek_bootbank_net-r8125_9.007.01-1.vib

关键点说明：

• 所有文件放在同一目录下，避免路径问题
• 驱动文件单独放在drivers子目录
• 路径中不要包含中文或特殊字符

3. 驱动集成操作步骤

3.1 运行集成脚本

进入文件所在目录，执行以下命令：

cd C:\ESXi_RTL8125_Integration .\ESXi-Customizer-PS-v2.6.0.ps1 .\ESXi670-202210001.zip -pkgDir .\drivers\

3.2 常见问题处理

在实际操作中可能会遇到以下问题及解决方案：

问题1：PowerCLI版本警告

警告: 已在...上安装"12.1.0.17009493"版本的模块"VMware.PowerCLI"...

解决方案：忽略此警告，不影响操作。或者使用-Force参数重新安装最新版。

问题2：CEIP参与提示

警告: Please consider joining the VMware Customer Experience Improvement Program...

解决方案：执行以下命令关闭提示：

Set-PowerCLIConfiguration -Scope User -ParticipateInCEIP $false -Confirm:$false

问题3：驱动签名验证失败

如果驱动签名有问题，可以尝试添加-nsc参数跳过签名检查：

.\ESXi-Customizer-PS-v2.6.0.ps1 .\ESXi670-202210001.zip -pkgDir .\drivers\ -nsc

4. 验证与测试

4.1 生成的ISO验证

成功执行后，会在当前目录生成一个名为ESXi-6.7.0-20221004001-standard-customized.iso的文件。可以通过以下方式验证：

1. 检查文件大小（通常应大于300MB）
2. 使用虚拟机挂载测试安装
3. 检查安装后系统是否识别RTL8125网卡

4.2 安装后网卡识别检查

在ESXi安装完成后，通过以下命令检查网卡是否被正确识别：

esxcli network nic list

应该能看到类似下面的输出：

Name PCI Device Driver Admin Status Link Status ------ ----------- ---------- ------------ ----------- vmnic0 0000:02:00.0 net-r8125 Up Up

5. 高级技巧与优化

5.1 批量集成多个驱动

如果需要集成多个驱动，只需将所有.vib文件放入drivers目录即可。脚本会自动处理所有驱动文件。

5.2 自定义ISO名称

通过-outDir和-ipname参数可以自定义输出路径和ISO名称：

.\ESXi-Customizer-PS-v2.6.0.ps1 .\ESXi670-202210001.zip -pkgDir .\drivers\ -outDir C:\Output -ipname "ESXi-6.7-RTL8125"

5.3 自动化脚本

可以将整个过程封装为一个脚本，实现一键操作：

# 一键集成脚本 $ErrorActionPreference = "Stop" try { # 安装PowerCLI Install-Module -Name VMware.PowerCLI -Force -AllowClobber # 设置执行策略 Set-ExecutionPolicy -ExecutionPolicy Unrestricted -Scope Process -Force # 运行集成脚本 .\ESXi-Customizer-PS-v2.6.0.ps1 .\ESXi670-202210001.zip -pkgDir .\drivers\ Write-Host "驱动集成成功完成！" -ForegroundColor Green } catch { Write-Host "发生错误: $_" -ForegroundColor Red }

6. 常见问题深度解析

6.1 驱动兼容性问题

RTL8125驱动有多个版本，不同版本对ESXi 6.7 U3的兼容性不同。以下是常见版本对比：

6.2 性能优化建议

安装完成后，可以通过以下设置优化RTL8125网卡性能：

# 禁用TSO esxcli system module parameters set -m net-r8125 -p "use_tso=0" # 设置中断节流 esxcli system module parameters set -m net-r8125 -p "rx_copybreak=2048"

6.3 驱动更新方法

如果需要更新驱动，无需重新制作ISO，可以通过以下步骤在线更新：

1. 将新驱动上传到ESXi主机
2. 执行以下命令：

esxcli software vib install -v /path/to/new-driver.vib --no-sig-check

7. 安全注意事项

在整个过程中，需要注意以下安全事项：

1. 驱动来源安全：只从Realtek官网或VMware兼容性列表获取驱动
2. 执行环境安全：确保操作电脑没有恶意软件
3. 网络传输安全：下载文件时使用HTTPS连接
4. 备份原始ISO：修改前保留原始安装文件

重要：生产环境使用前，务必在测试环境充分验证定制ISO的稳定性和兼容性。