GeekIt

ESXi esxcli命令速查

系统与维护模式、vSwitch 与 VMkernel、防火墙诊断、存储与 VMFS、虚拟机操作、硬件驱动、升级与报错排查等 180 条命令

共 180 条命令 · 11 类场景 · 点击右侧图标可复制

命令 / 片段说明复制
esxcli --help查看命名空间树,命令按 network/storage 等分组
esxcli system version get查看 ESXi 版本、build 号与补丁级别
esxcli system hostname get查看主机名与域名
esxcli system hostname set --fqdn=esx01.example.com设置 FQDN,集群管理依赖名称解析
esxcli system uuid get查看主机 UUID,授权与日志排查用
esxcli system stats uptime get查看运行时长,判断是否刚重启过
esxcli system maintenanceMode get查看是否处于维护模式
esxcli system maintenanceMode set --enable true进入维护模式,前提是虚拟机已迁移或关机
esxcli system maintenanceMode set --enable false退出维护模式
esxcli system shutdown reboot --reason "patch"重启主机,必须填写原因便于审计
esxcli system shutdown poweroff --reason "retire"关机,确认无业务后再执行
esxcli system syslog config get查看远程日志配置,排障前先确认日志有没有送出去
esxcli system syslog config set --loghost=udp://10.0.0.10:514配置远程 syslog
esxcli system syslog reload改完日志配置后重载生效
esxcli system module list查看已加载的内核模块
esxcli system settings advanced list -o /UserVars/ESXiShellTimeOut查看高级参数,改前先确认默认值
esxcli system account list列出本地账户
esxcli system permission list查看权限分配(仅本机层面)
esxcli system snmp get查看 SNMP 配置,监控接入常用
esxcli system coredump partition list查看转储分区,排查主机紫屏问题
esxcli system time get查看主机时间,与 vCenter 时间偏差过大会出问题
命令 / 片段说明复制
esxcli network nic list列出物理网卡、速率、双工与状态
esxcli network nic get -n vmnic0查看单块网卡的详细驱动与队列信息
esxcli network vswitch standard list列出标准交换机、MTU 与挂载的上行链路
esxcli network vswitch standard add -v vSwitch1新建标准交换机
esxcli network vswitch standard remove -v vSwitch1删除交换机,先确认无端口组与上行
esxcli network vswitch standard uplink add -u vmnic1 -v vSwitch1给交换机添加物理上行
esxcli network vswitch standard uplink remove -u vmnic1 -v vSwitch1移除上行链路
esxcli network vswitch standard portgroup add -p "VM Network" -v vSwitch0新建端口组
esxcli network vswitch standard portgroup set -p "VM Network" -v 100给端口组打 VLAN ID
esxcli network vswitch standard portgroup set -p "VM Network" -v 0取消 VLAN 标记
esxcli network vswitch standard portgroup remove -p "VM Network" -v vSwitch0删除端口组
esxcli network vswitch standard set -v vSwitch0 -m 9000设置交换机 MTU,vMotion 与存储网络常用 9000
esxcli network vswitch dvs vmware list查看分布式交换机与端口组
esxcli network vswitch standard policy failover get -v vSwitch0查看负载均衡与故障切换策略
esxcli network vswitch standard policy security get -v vSwitch0查看混杂模式、MAC 变更等安全策略
esxcli network vm list列出虚拟机及其网络端口占用
esxcli network nic up -n vmnic1启用网卡
esxcli network nic down -n vmnic1禁用网卡,先确认业务已迁移
命令 / 片段说明复制
esxcli network ip interface list列出 VMkernel 接口与所属交换机
esxcli network ip interface ipv4 get查看各 VMkernel 的 IPv4 配置
esxcli network ip interface add -i vmk1 -p "VMkernel"新建 VMkernel 接口
esxcli network ip interface ipv4 set -i vmk0 -t static -I 10.0.0.10 -N 255.255.255.0 -G 10.0.0.1设置静态 IP、掩码与网关
esxcli network ip interface ipv4 set -i vmk0 -t dhcp改为 DHCP,生产管理口不建议
esxcli network ip interface tag add -i vmk1 -t VMotion给接口打 vMotion 标签
esxcli network ip interface tag add -i vmk2 -t Provisioning标记为置备流量
esxcli network ip interface remove -i vmk1删除 VMkernel 接口
esxcli network ip route ipv4 list查看路由表
esxcli network ip route ipv4 add -n 10.1.0.0/16 -g 10.0.0.1添加静态路由
esxcli network ip route ipv4 remove -n 10.1.0.0/16 -g 10.0.0.1删除静态路由
esxcli network ip dns server list查看 DNS 服务器
esxcli network ip dns server add --server=10.0.0.2添加 DNS 服务器
esxcli network ip dns search add --domain=example.com添加搜索域
esxcli network ip neighbor list查看 ARP 邻居表
esxcli network ip connection list等价 netstat,查看本机连接与端口
esxcli network ip netstats get查看网络统计与错误计数
命令 / 片段说明复制
esxcli network firewall get查看防火墙是否启用与默认动作
esxcli network firewall ruleset list列出全部规则集与启用状态
esxcli network firewall ruleset set -e true -r httpClient放行出站 HTTP,调用外部 API 时需要
esxcli network firewall ruleset set -e true -r sshServer放行 SSH
esxcli network firewall ruleset set -e true -r nfsClient放行 NFS 客户端
esxcli network firewall ruleset allowedip list -r sshServer查看规则集允许的来源 IP
esxcli network firewall ruleset allowedip add -r sshServer -i 10.0.0.0/24限制来源网段,比全放开安全
esxcli network firewall refresh重载规则,改完规则集后执行
esxcli network diag ping -h 10.0.0.1从主机发起 ping,验证二层与网关
esxcli network diag ping -h 10.0.0.1 -I vmk1指定源接口,排查多网段路由
esxcli network diag trace -h 10.0.0.1路由追踪
vmkping -I vmk1 10.0.0.1 -s 8972 -d验证 jumbo frame 是否端到端生效
vmkping -I vmk1 10.0.0.1 -S 9000按指定包大小测试,配合 MTU 排障
nc -z 10.0.0.1 443测试端口连通性
tcpdump-uw -i vmk0 -nn port 53ESXi 上抓包,定位网络问题
命令 / 片段说明复制
esxcli storage core adapter list列出 HBA 与驱动状态
esxcli storage core device list列出所有 LUN/磁盘及状态
esxcli storage core device list -d naa.6000c29...查看指定设备的详细信息
esxcli storage core device smart get -d naa.xxx读取磁盘 SMART 健康信息
esxcli storage core path list列出多路径,检查是否单路径运行
esxcli storage core path list -d naa.xxx只看某设备的多路径状态
esxcli storage nmp device list查看设备的 PSP 策略与路径
esxcli storage nmp satp rule add -s VMW_SATP_ALUA -V NETAPP -M FAS -P VMW_PSP_RR按厂商加多路径规则
esxcli storage core claimrule list查看设备认领规则
esxcli storage core device set --state=off -d naa.xxx下线设备,强制卸载前使用
esxcli storage core device detached list查看已分离设备
esxcli storage core device partition list -d naa.xxx查看设备上的分区
esxcli iscsi adapter list查看 iSCSI 适配器
esxcli iscsi adapter discovery sendtarget add -a vmhba64 -A 10.0.0.20:3260添加 iSCSI 目标
esxcli iscsi adapter discovery sendtarget list -a vmhba64查看已配置的 iSCSI 目标
esxcli storage san fc list查看 FC HBA 与 WWN
esxcli storage san fc events get查看 FC 链路事件,排查丢路径
路径全为 dead 时先查交换机与 zoning多数问题不在 ESXi 侧
命令 / 片段说明复制
esxcli storage filesystem list列出数据存储、容量与挂载状态
esxcli storage vmfs extent list查看 VMFS 的 extent 组成
esxcli storage vmfs volume get -l datastore1查看 VMFS 版本、块大小与 UUID
esxcli storage vmfs snapshot list列出快照卷(resignature 候选)
esxcli storage vmfs snapshot resignature -l naa.xxx重新签名后挂载,解决重名与 UUID 冲突
esxcli storage vmfs unmap -l datastore1回收 thin 精简置备未使用空间
esxcli storage vmfs unmap -l datastore1 --reclaim-unit=200调整回收单元,控制 IO 压力
esxcli storage filesystem rescan重新扫描存储,新加 LUN 后执行
esxcli storage filesystem mount -l datastore1挂载文件系统
esxcli storage filesystem unmount -l datastore1卸载数据存储,先关掉相关虚拟机
esxcli storage filesystem list --volume-only只列卷,输出更简洁
df -hESXi 命令行也能用,快速看剩余空间
voma -m vmfs -f check -d /vmfs/devices/disks/naa.xxx检查 VMFS 元数据一致性,需先卸载
扩容 VMFS 前先扩 LUN存储侧扩容后再执行 grow,否则看不到新容量
命令 / 片段说明复制
esxcli vm process list列出正在运行的虚拟机与 World ID
esxcli vm process kill --type=soft --world-id=12345发送正常关机信号,最温和
esxcli vm process kill --type=hard --world-id=12345强制停止进程
esxcli vm process kill --type=force --world-id=12345最后手段,可能损坏磁盘
vim-cmd vmsvc/getallvms列出虚拟机与 VMID
vim-cmd vmsvc/get.summary 12查看虚拟机概要:电源、资源与 IP
vim-cmd vmsvc/get.config 12查看虚拟机配置
vim-cmd vmsvc/power.on 12开机
vim-cmd vmsvc/power.off 12强制关机,等价断电
vim-cmd vmsvc/power.shutdown 12请求客户机优雅关机
vim-cmd vmsvc/power.reboot 12重启
vim-cmd vmsvc/power.getstate 12查询电源状态,脚本判断用
vim-cmd vmsvc/snapshot.create 12 snap1 "升级前" 0 1创建快照,参数依次为名称、描述、含内存、静默
vim-cmd vmsvc/snapshot.get 12查看快照树
vim-cmd vmsvc/snapshot.revert 12 0 1回滚到快照
vim-cmd vmsvc/snapshot.removeall 12删除全部快照,可能耗时较长
vim-cmd vmsvc/tools.install 12挂载 VMware Tools 安装镜像
vim-cmd vmsvc/destroy 12从清单中删除虚拟机(磁盘保留)
esxcli 看状态,vim-cmd 做动作两者互补,虚拟机电源类操作 vim-cmd 更直接
命令 / 片段说明复制
esxcli hardware platform get查看服务器厂商、型号与序列号
esxcli hardware memory get查看物理内存总量与可用量
esxcli hardware cpu list列出每颗 CPU 的型号、主频与核心数
esxcli hardware cpu global get查看超线程与 NUMA 全局设置
esxcli hardware cpu global set -e true开启超线程
esxcli hardware pci list列出 PCI 设备与驱动绑定,排查网卡识别的第一步
esxcli hardware pci list -c 0:3:0查看指定 PCI 地址的设备详情
esxcli hardware ipmi sdr list读取 IPMI 传感器,看温度与风扇
esxcli hardware clock get查看硬件时钟
esxcli hardware usb passthrough device list查看可直通的 USB 设备(加密狗场景)
esxcli hardware trustedboot get查看安全启动与可信启动状态
lspci -p更直观的 PCI 设备与驱动对照
vmkload_mod -l | grep ixgbe确认网卡驱动是否已加载
esxcli system module get -m ixgbe查看模块版本与签名信息
命令 / 片段说明复制
esxcli software vib list列出已安装的 VIB 组件
esxcli software vib list | grep -i driver筛出驱动类 VIB,升级前先记录版本
esxcli software sources profile list -d /vmfs/volumes/datastore1/update.zip查看离线包内可用的 profile
esxcli software profile update -d /vmfs/volumes/datastore1/update.zip -p ESXi-8.0U3-xxxx-standard按 profile 升级,最推荐的方式
esxcli software profile update -d ./update.zip -p PROFILE --no-hardware-warning跳过硬件兼容警告,生产慎用
esxcli software vib install -d /vmfs/volumes/datastore1/driver.zip安装单个 VIB 或驱动包
esxcli software vib remove -n net-ixgbe卸载 VIB,注意依赖关系
esxcli software acceptance get查看当前验收级别
esxcli software acceptance set --level=CommunitySupported降低验收级别以安装社区驱动,事后应评估风险
esxcli software baseimage get查看基础镜像版本
esxcli software component list新版把组件独立管理,查看组件清单
升级前必须进维护模式并有可回滚的备份与带外管理通道
升级后重启主机不重启时部分内核模块仍是旧版本
esxcli system version get升级完成后核对 build 号是否变化
命令 / 片段说明复制
esxcli system version get && esxcli hardware platform get接手上机第一步:确认版本与机型
esxcli network nic list && esxcli network vswitch standard list核对物理网卡与交换机映射
esxcli network vswitch standard add -v vSwitch1 && esxcli network vswitch standard uplink add -u vmnic1 -v vSwitch1 && esxcli network vswitch standard portgroup add -p "VM Network" -v vSwitch1新建一套完整网络
esxcli network ip interface add -i vmk1 -p "VMkernel" && esxcli network ip interface ipv4 set -i vmk1 -t static -I 10.0.0.11 -N 255.255.255.0 -G 10.0.0.1新增管理或 vMotion 接口
esxcli storage core device list | grep -i naa && esxcli storage core path list -d naa.xxx检查新挂 LUN 与多路径是否正常
esxcli storage vmfs snapshot list && esxcli storage vmfs snapshot resignature -l naa.xxx快照卷重新签名后挂载
esxcli storage vmfs unmap -l datastore1回收精简置备空间,业务低峰执行
esxcli vm process list | grep -i 虚拟机名找到僵死虚拟机的 World ID
esxcli vm process kill --type=hard --world-id=12345确认为僵死后强制结束,随后检查磁盘一致性
vim-cmd vmsvc/getallvms && vim-cmd vmsvc/power.getstate 12脚本化巡检虚拟机电源状态
esxcli software sources profile list -d ./u3.zip && esxcli software profile update -d ./u3.zip -p PROFILE标准升级两步走
esxcli system maintenanceMode set --enable true && esxcli system shutdown reboot --reason "upgrade"维护窗口的标准收尾
命令 / 片段说明复制
Unknown command or namespace子命令拼错或该版本没有此命令,逐层用 --help 探
Error: Unknown option参数名不对,注意 kebab-case 与等号写法
Permission denied需要 root,或 SSH 未开启、账户无权限
Failed to enter maintenance mode还有虚拟机在运行,先迁移或关机
The object has already been deleted or has not been completely created操作对象已变更,重试刷新清单
Cannot complete the operation because the file or folder is busy文件被虚拟机占用,先关机再操作
VMFS 卷显示为 snapshot 且未挂载用 vmfs snapshot list 查看后 resignature
Unable to mount VMFS: duplicate UUID同一 LUN 被两台主机同时识别,需重新签名
device or resource busy设备仍被挂载或占用,先卸载再下线
No such devicenaa 或 vmhba 编号写错,用 list 复制实际值
VIB 安装报签名或验收级别错误调整 acceptance level 或使用官方签名包
hardware warning 导致 profile update 中止核对 HCL,确认后再考虑跳过警告
ssh 连不上主机先在 DCUI 开启 SSH,并检查防火墙 sshServer 规则
命令输出被截断看不清管道给 less,或加 --formatter=keyvalue
改了配置但立即回滚部分设置需重启相关服务或主机才持久化
vMotion 迁移失败检查 vMotion 标签、网段与 MTU 是否一致
存储路径全 dead多为交换机 zoning、iSCSI 会话或链路故障
主机时间漂移配置 NTP,时间偏差会引发证书与集群异常

运维常用组合

新机初始化esxcli system hostname set --fqdn=esx01.example.com → esxcli network ip dns server add --server=10.0.0.2 → esxcli network ip route ipv4 add -n 10.1.0.0/16 -g 10.0.0.1 → 配置 syslog 与 NTP
新增业务网络vswitch standard add → uplink add → portgroup add → portgroup set -v 100 → vswitch standard set -m 9000(按需)
新挂 LUN 排障esxcli storage core adapter rescan --all → esxcli storage core device list → esxcli storage core path list -d naa.xxx → 确认多路径均衡
空间回收esxcli storage filesystem list → esxcli storage vmfs unmap -l datastore1 --reclaim-unit=200 → 观察存储 IO 与剩余容量
僵死虚拟机处理esxcli vm process list | grep 名称 → esxcli vm process kill --type=soft --world-id=N → 无效再 hard → 事后检查磁盘
离线升级上传 zip 到 datastore → esxcli software sources profile list -d /vmfs/volumes/ds1/u3.zip → 进维护模式 → profile update → reboot → version get 核对

实战要点

1. 先看 --help 再敲命令

esxcli 命名空间层级深,逐层 --help 比背参数快

2. 改配置前记录原值

先 get 再 set,回滚时需要原始参数

3. 维护模式是前置条件

升级、改驱动、下线存储前都要先进维护模式

4. 状态用 esxcli,动作用 vim-cmd

虚拟机电源与快照操作 vim-cmd 更直接

5. 多路径要成对检查

设备列表正常不代表路径正常,path list 看 dead 数量

6. 别在业务高峰期 unmap

空间回收会产生大量 IO,低峰执行并控制 reclaim-unit

共 180 条 esxcli 命令 · 示例中的主机名、IP 与设备号请替换为实际环境

关于ESXi esxcli命令速查

在线 ESXi esxcli 命令速查手册,按基础与系统、网络 vSwitch 与端口组、VMkernel 与路由 DNS、防火墙与网络诊断、存储设备与路径、VMFS 与数据存储、虚拟机操作、硬件与驱动、软件与升级、实战组合、常见报错与排查等 11 类场景整理 170 余条常用命令与参数组合,每条附中文说明与可直接复制的写法,支持关键词搜索、分类折叠和一键复制,打开网页即可查阅。涵盖 esxcli system version get 与 hostname get/set 与 maintenanceMode set --enable 与 shutdown reboot --reason 与 stats uptime get 与 syslog config get/set 与 settings advanced list 与 module list 与 account/permission/snmp/coredump、esxcli network nic list/get 与 vswitch standard list/add/uplink add/portgroup add/portgroup set -v VLAN 与 vswitch dvs vmware list 与 network vm list 与 ip interface list/add 与 ipv4 get/set -t static -I -N -G 与 ip route ipv4 list/add 与 ip dns server add 与 ip connection list 与 diag ping/trace、esxcli network firewall get 与 ruleset list/set -e true -r、esxcli storage core adapter list 与 core device list 与 device smart get 与 core path list 与 core claimrule list 与 nmp device list/satp rule add 与 iscsi adapter list 与 adapter discovery sendtarget add 与 san fc list、esxcli storage filesystem list 与 vmfs extent list 与 vmfs volume get 与 vmfs unmap -l 与 vmfs snapshot list/resignature 与 core device set --state=off 与 detached list、esxcli vm process list 与 vm process kill --type=soft|hard|force --world-id 与 vim-cmd vmsvc/getallvms/power.off/snapshot.create/snapshot.revert/get.summary/tools.install、esxcli hardware platform/memory/cpu/pci/ipmi sdr/clock 与 cpu global set -e 与 usb passthrough device list、esxcli software vib list/install/remove 与 software profile update 与 sources profile list 与 acceptance get/set,还有 Unknown command or namespace、Unknown option、Permission denied、Failed to enter maintenance mode、VMFS 无法挂载需 resignature、vib 签名与 acceptance level、device is busy、No such device、SSH 未开启、输出过长被截断 等报错排查。适用于 ESXi 主机初始化与网络配置、vSwitch 与 VLAN 排障、存储路径与 VMFS 扩容回收、虚拟机僵死进程处理、驱动与补丁升级、维护模式与关机流程,以及 VMware 虚拟化运维与面试复习。

核心能力

  • 涵盖 esxcli system version get 与 hostname get/set 与 maintenanceMode set --enable 与 shutdown reboot --reason 与 stats uptime get 与 syslog config get/set 与 settings advanced list 与 module list 与 account/permission/snmp/coredump、esxcli network nic list/get 与 vswitch standard list/add/uplink add/portgroup add/portgroup set -v VLAN 与 vswitch dvs vmware list 与 network vm list 与 ip interface list/add 与 ipv4 get/set -t static -I -N -G 与 ip route ipv4 list/add 与 ip dns server add 与 ip connection list 与 diag ping/trace、esxcli network firewall get 与 ruleset list/set -e true -r、esxcli storage core adapter list 与 core device list 与 device smart get 与 core path list 与 core claimrule list 与 nmp device list/satp rule add 与 iscsi adapter list 与 adapter discovery sendtarget add 与 san fc list、esxcli storage filesystem list 与 vmfs extent list 与 vmfs volume get 与 vmfs unmap -l 与 vmfs snapshot list/resignature 与 core device set --state=off 与 detached list、esxcli vm process list 与 vm process kill --type=soft|hard|force --world-id 与 vim-cmd vmsvc/getallvms/power.off/snapshot.create/snapshot.revert/get.summary/tools.install、esxcli hardware platform/memory/cpu/pci/ipmi sdr/clock 与 cpu global set -e 与 usb passthrough device list、esxcli software vib list/install/remove 与 software profile update 与 sources profile list 与 acceptance get/set,还有 Unknown command or namespace、Unknown option、Permission denied、Failed to enter maintenance mode、VMFS 无法挂载需 resignature、vib 签名与 acceptance level、device is busy、No such device、SSH 未开启、输出过长被截断 等报错排查

适用场景

适用于 ESXi 主机初始化与网络配置、vSwitch 与 VLAN 排障、存储路径与 VMFS 扩容回收、虚拟机僵死进程处理、驱动与补丁升级、维护模式与关机流程,以及 VMware 虚拟化运维与面试复习。ESXi esxcli命令速查全程在浏览器中完成,无需安装插件,可放心用于日常办公与排障。

常见问题

ESXi esxcli命令速查是免费的吗?需要注册或安装吗?
ESXi esxcli命令速查完全免费,无需注册、无需下载安装任何软件,用浏览器打开网页即可直接使用,也不限制使用次数。
ESXi esxcli命令速查支持哪些功能?
涵盖 esxcli system version get 与 hostname get/set 与 maintenanceMode set --enable 与 shutdown reboot --reason 与 stats uptime get 与 syslog config get/set 与 settings advanced list 与 module list 与 account/permission/snmp/coredump、esxcli network nic list/get 与 vswitch standard list/add/uplink add/portgroup add/portgroup set -v VLAN 与 vswitch dvs vmware list 与 network vm list 与 ip interface list/add 与 ipv4 get/set -t static -I -N -G 与 ip route ipv4 list/add 与 ip dns server add 与 ip connection list 与 diag ping/trace、esxcli network firewall get 与 ruleset list/set -e true -r、esxcli storage core adapter list 与 core device list 与 device smart get 与 core path list 与 core claimrule list 与 nmp device list/satp rule add 与 iscsi adapter list 与 adapter discovery sendtarget add 与 san fc list、esxcli storage filesystem list 与 vmfs extent list 与 vmfs volume get 与 vmfs unmap -l 与 vmfs snapshot list/resignature 与 core device set --state=off 与 detached list、esxcli vm process list 与 vm process kill --type=soft|hard|force --world-id 与 vim-cmd vmsvc/getallvms/power.off/snapshot.create/snapshot.revert/get.summary/tools.install、esxcli hardware platform/memory/cpu/pci/ipmi sdr/clock 与 cpu global set -e 与 usb passthrough device list、esxcli software vib list/install/remove 与 software profile update 与 sources profile list 与 acceptance get/set,还有 Unknown command or namespace、Unknown option、Permission denied、Failed to enter maintenance mode、VMFS 无法挂载需 resignature、vib 签名与 acceptance level、device is busy、No such device、SSH 未开启、输出过长被截断 等报错排查。
ESXi esxcli命令速查适合哪些场景使用?
适用于 ESXi 主机初始化与网络配置、vSwitch 与 VLAN 排障、存储路径与 VMFS 扩容回收、虚拟机僵死进程处理、驱动与补丁升级、维护模式与关机流程,以及 VMware 虚拟化运维与面试复习。