如何在PowerShell中通过ESXCLI更新ESXi 6.5补丁及报错排查

1. 路径兼容性验证 #

ESXi 6.5对数据存储路径的解析规则和7.x版本存在明显差异，优先排查路径问题：

• 不要直接使用/vmfs/volumes/[存储别名]/的软链路径，优先替换为存储对应的UUID全路径，6.5对别名路径的解析兼容性较差。可先登录ESXi主机SSH控制台执行ls -l /vmfs/volumes/，确认MasterImages对应的UUID，替换路径后测试是否能正常访问补丁文件
• 打印PowerCLI会话中$patchfilepath变量的实际值，确认不存在转义错误、多余空格、特殊字符，6.5的esxcli接口对路径字符串的校验比7.x严格，路径中不要包含中文、空格，特殊字符必须完全转义

2. 补丁文件校验 #

• 直接在ESXi主机本地执行命令测试补丁可用性：

  esxcli software sources profile list -d /vmfs/volumes/MasterImages/Patches/ESXi650-20210704001/ESXi650-20210704001.zip
  

  如果本地执行仍报错，要么补丁包损坏，要么补丁和当前ESXi 6.5的小版本不兼容，可重新下载官方对应版本补丁包、校验MD5后重新上传测试
• 手动解压补丁包，确认根目录直接存在index.xml文件，排除补丁包被二次压缩、修改导致结构损坏的问题

3. PowerCLI调用逻辑适配 #

你当前使用的software.vib.update接口在ESXi 6.5中对离线包的支持存在已知缺陷，推荐替换为profile更新逻辑：

# 替换为profile更新参数创建逻辑
$argsInstall = $esxcli.software.profile.update.createargs()
$argsInstall.depot = $patchfilepath
# 新增指定profile参数，参数值可通过上文中的sources profile list命令查询，例如ESXi-6.5.0-20210704001-standard
$argsInstall.profile = "ESXi-6.5.0-20210704001-standard"
$argsInstall.oktoremove = $true
$esxcli.software.profile.update.Invoke($argsInstall)

• 确认当前使用的PowerCLI版本，12.x及以上版本的PowerCLI对ESXi 6.5的兼容性下降，可降级到PowerCLI 11.x版本重试

4. 主机权限与服务验证 #

• 确认ESXi 6.5主机的ESXCLI服务、HTTP客户端服务处于正常运行状态，本地防火墙没有拦截存储文件访问请求
• 确认运行PowerCLI的账号对MasterImages数据存储有读取权限，6.5对跨会话的存储权限校验比7.x更严格，可尝试将补丁包上传到主机本地存储而非共享存储测试

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