BMC CLI 接口总览
更新时间: 2026/07/28
在Gitcode上查看源码修订记录
| Version | Date | Description |
|---|---|---|
| 1.0 | 2026/07/28 | 初稿 |
概述
BMC CLI 是登录 BMC 后通过 SSH 或串口执行系统管理和查询操作的命令行工具集。命令详情由 rackmount/interface_config/cli 配置自动生成。下文按功能分类列出所有命令。
主备管理
| 命令格式 | 命令功能 |
|---|---|
ipmcget -d redundancy | 查询主备冗余状态 |
ipmcset -d failover | 执行主备倒换 |
证书管理
| 命令格式 | 命令功能 |
|---|---|
ipmcget -t certificate -d info | 查询服务器证书信息 |
ipmcset -t certificate -d import | 导入证书 |
配置导入导出
| 命令格式 | 命令功能 |
|---|---|
ipmcget -t config -d export | 导出配置文件 |
ipmcget -t config -d importresult | 查询导入配置的校验结果 |
ipmcset -t config -d import | 导入配置 |
CRL
| 命令格式 | 命令功能 |
|---|---|
ipmcset -d crl | 导入 CRL 证书吊销列表文件 |
装备测试
| 命令格式 | 命令功能 |
|---|---|
ipmcget -t maintenance -d boardlog | 查询单板日志 |
ipmcset -t maintenance -d accycle | 交流上下电循环 |
环境变量
| 命令格式 | 命令功能 |
|---|---|
ipmcget -t envvar -d hostgmac | 查询主机 GMAC 地址 |
ipmcset -t envvar -d hostgmac | 设置主机 GMAC 地址 |
FRU
| 命令格式 | 命令功能 |
|---|---|
ipmcget -d fruinfo | 查询 FRU 信息 |
ipmcget -d health | 查询健康状态 |
ipmcget -d healthevents | 查询 FRU0 健康事件 |
ipmcget -d healthevents | 查询健康事件 |
ipmcget -d powerstate | 查询 FRU0 上电和下电状态 |
ipmcget -d powerstate | 查询设备上电和下电状态 |
ipmcget -d shutdowntimeout | 查询设备下电时限功能的状态和下电时限值 |
ipmcget -t fru0 -d health | 查询 FRU0 健康状态 |
ipmcget -t fru0 -d shutdowntimeout | 查询设备下电时限功能的状态和下电时限值 |
ipmcset -d frucontrol | 控制 FRU0 |
ipmcset -d frucontrol | 控制 FRU |
ipmcset -d powerstate | 设置 FRU0 上电和下电状态 |
ipmcset -d powerstate | 设置设备上电和下电状态 |
ipmcset -d sel | 清除系统 SEL 信息 |
ipmcset -d sel | 清除系统 SEL 信息 |
ipmcset -d shutdowntimeout | 设置设备下电时限 |
ipmcset -t fru0 -d shutdowntimeout | 设置设备下电时限 |
IPMI
| 命令格式 | 命令功能 |
|---|---|
ipmcset -d ipmiraw | 发送 IPMI 命令并获取响应 |
ipmcset -t ipmb -d ipmiraw | 发送 IPMI 命令并获取响应 |
LLDP
| 命令格式 | 命令功能 |
|---|---|
ipmcset -t lldp -d status | 设置 LLDP 启用状态 |
LAN 交换机
| 命令格式 | 命令功能 |
|---|---|
ipmcget -t lsw -d configinfo | 查询 LAN 交换机网络配置状态 |
ipmcset -t lsw -d reset | 复位 LAN 交换机 |
维护诊断
| 命令格式 | 命令功能 |
|---|---|
ipmcget -d blackbox | 下载黑匣子数据 |
ipmcget -d diaginfo | 一键收集信息 |
ipmcget -d operatelog | 查询系统操作日志 |
ipmcget -d sel | 打印系统 SEL 信息 |
ipmcget -t maintenance -d biosprint | 查看 BIOS 打印开关信息 |
ipmcget -t maintenance -d catlog | 查看指定类型日志 |
ipmcget -t maintenance -d dumpdfxlog | 导出 DFX 日志 |
ipmcget -t maintenance -d ipinfo | 查询专有端口维护 IP 地址信息 |
ipmcget -t maintenance -d listcsr | 查询 CSR 寄存器列表 |
ipmcget -t maintenance -d loglist | 查询可查看的日志类型列表 |
ipmcget -t maintenance -d poweronlock | 查询上电锁状态 |
ipmcget -t maintenance -d retiresystem | 查询报废状态 |
ipmcset -t maintenance -d biosprint | 设置 BIOS 打印开关 |
ipmcset -t maintenance -d callredfish | 调用 Redfish 接口 |
ipmcset -t maintenance -d download | 下载文件 |
ipmcset -t maintenance -d ethlink | 设置以太网端口链路状态 |
ipmcset -t maintenance -d importcsr | 导入 CSR 证书签名请求 |
ipmcset -t maintenance -d ipaddr | 设置维护 IP 地址 |
ipmcset -t maintenance -d poweronlock | 清除上电锁 |
ipmcset -t maintenance -d psualarmlatch | 设置电源告警锁存状态 |
ipmcset -t maintenance -d resetiME | 复位 ARM iME 管理引擎 |
ipmcset -t maintenance -d retiresystem | 报废系统 |
ipmcset -t maintenance -d upgradebios | 升级 BIOS |
网络配置
| 命令格式 | 命令功能 |
|---|---|
ipmcget -d ethport | 查询设备上可用网口信息 |
ipmcget -d ipinfo | 查询 IP 信息 |
ipmcget -d lldpinfo | 查询 iBMC 的 LLDP 信息 |
ipmcget -d macaddr | 查询设备主板上网口的 MAC 地址 |
ipmcset -d activeport | 设置 EthGroup 激活端口 |
ipmcset -d backupipaddr | 设置备份 IP 地址 |
ipmcset -d gateway | 设置网关 |
ipmcset -d gateway6 | 设置 IPv6 网关 |
ipmcset -d ipaddr | 设置 IP 地址 |
ipmcset -d ipaddr6 | 设置 IPv6 地址 |
ipmcset -d ipmode | 设置 IP 模式 |
ipmcset -d ipmode6 | 设置 IPv6 模式 |
ipmcset -d ipversion | 设置 IP 协议版本 |
ipmcset -d netmode | 设置网络模式 |
ipmcset -d vlan | 设置带外 VLAN |
NTP 时间同步
| 命令格式 | 命令功能 |
|---|---|
ipmcget -d ntpinfo | 查询 iBMC 的 NTP 信息 |
ipmcset -t ntp -d alternativeserver | 设置备用 NTP 服务器地址 |
ipmcset -t ntp -d authstatus | 启用认证状态 |
ipmcset -t ntp -d extraserver | 设置拓展 NTP 服务器地址 |
ipmcset -t ntp -d groupkey | 导入 NTP 组密钥 |
ipmcset -t ntp -d mode | 设置 NTP 信息获取方式 |
ipmcset -t ntp -d preferredserver | 设置首选 NTP 服务器地址 |
ipmcset -t ntp -d status | 设置 NTP 功能的使能状态 |
电源管理
| 命令格式 | 命令功能 |
|---|---|
ipmcget -d psuinfo | 获取电源信息 |
ipmcset -d psuswitch | 设置 PSU 电源开关 |
ipmcset -d psuworkmode | 设置 PSU 工作模式 |
精准告警
| 命令格式 | 命令功能 |
|---|---|
ipmcset -t precisealarm -d mock | 模拟系统事件 |
登录安全公告
| 命令格式 | 命令功能 |
|---|---|
ipmcget -t securitybanner -d info | 查询登录安全信息 |
ipmcset -t securitybanner -d content | 设置登录安全信息内容 |
ipmcset -t securitybanner -d state | 设置登录安全信息启用状态 |
安全增强
| 命令格式 | 命令功能 |
|---|---|
ipmcget -t securityenhance -d inactivetimelimit | 查询非活跃用户锁定时限(天) |
ipmcget -t securityenhance -d masterkeyupdateinterval | 查询主密钥更新间隔信息 |
ipmcset -t securityenhance -d inactivetimelimit | 设置非活跃用户锁定时限(天) |
ipmcset -t securityenhance -d masterkeyupdateinterval | 设置主密钥自动更新间隔(天) |
ipmcset -t securityenhance -d updatemasterkey | 更新主密钥 |
传感器
| 命令格式 | 命令功能 |
|---|---|
ipmcget -t sensor -d list | 查询所有传感器信息 |
ipmcset -t sensor -d state | 设置传感器启用状态 |
ipmcset -t sensor -d test | 传感器测试 |
服务管理
| 命令格式 | 命令功能 |
|---|---|
ipmcget -t service -d list | 列出所有服务信息 |
ipmcset -t service -d port | 设置服务端口号 |
ipmcset -t service -d state | 设置服务启用状态 |
SMBIOS
| 命令格式 | 命令功能 |
|---|---|
ipmcget -d serialnumber | 查询设备的设备序列号 |
ipmcget -t smbios -d serialnumber | 打印 SMBIOS 序列号 |
SOL
| 命令格式 | 命令功能 |
|---|---|
ipmcget -t sol -d info | 查询 SOL 会话配置信息 |
ipmcget -t sol -d session | 查询 SOL 会话列表 |
ipmcset -t sol -d activate | 建立 SOL 会话 |
ipmcset -t sol -d deactivate | 强制注销 SOL 会话 |
ipmcset -t sol -d timeout | 设置 SOL 超时时间(分钟) |
存储管理
| 命令格式 | 命令功能 |
|---|---|
ipmcget -t storage -d arrayinfo | 查询磁盘阵列信息 |
ipmcget -t storage -d ctrlinfo | 查询 RAID 控制器信息 |
ipmcget -t storage -d ldinfo | 查询逻辑驱动器信息 |
ipmcget -t storage -d pdinfo | 查询物理驱动器信息 |
ipmcset -t storage -d addld | 在已有磁盘阵列上添加逻辑驱动器 |
ipmcset -t storage -d createld | 创建逻辑驱动器 |
ipmcset -t storage -d ctrlconfig | 设置 RAID 控制器配置 |
ipmcset -t storage -d deleteld | 删除逻辑驱动器 |
ipmcset -t storage -d ldconfig | 设置逻辑驱动器配置 |
ipmcset -t storage -d pdconfig | 设置物理驱动器配置 |
系统日志
| 命令格式 | 命令功能 |
|---|---|
ipmcget -t syslog -d auth | 查询系统日志认证类型 |
ipmcget -t syslog -d clientcertificate | 查询系统日志客户端证书信息 |
ipmcget -t syslog -d identity | 查询系统日志标识 |
ipmcget -t syslog -d iteminfo | 查询系统日志目标条目信息 |
ipmcget -t syslog -d protocol | 查询系统日志协议 |
ipmcget -t syslog -d rootcertificate | 查询系统日志根证书信息 |
ipmcget -t syslog -d severity | 查询系统日志发送严重级别 |
ipmcget -t syslog -d state | 查询系统日志启用状态 |
ipmcset -t syslog -d address | 设置系统日志目标地址 |
ipmcset -t syslog -d auth | 设置系统日志认证类型 |
ipmcset -t syslog -d identity | 设置系统日志标识 |
ipmcset -t syslog -d logtype | 设置系统日志目标日志类型 |
ipmcset -t syslog -d port | 设置系统日志目标端口 |
ipmcset -t syslog -d protocol | 设置系统日志传输协议 |
ipmcset -t syslog -d rootcertificate | 导入系统日志根证书 |
ipmcset -t syslog -d severity | 设置系统日志发送严重级别 |
ipmcset -t syslog -d state | 设置系统日志启用状态 |
ipmcset -t syslog -d test | 测试系统日志目标发送 |
系统管理
| 命令格式 | 命令功能 |
|---|---|
ipmcget -d bootdevice | 查询启动设备 |
ipmcget -d ledinfo | 查询 LED 指示灯信息 |
ipmcget -d rollbackstatus | 查询回滚状态 |
ipmcget -d serialdir | 查询当前串口方向 |
ipmcget -d systemcom | 下载系统串口数据 |
ipmcget -d time | 查询 iBMC 时间 |
ipmcget -d version | 查询设备的版本信息 |
ipmcset -d bootdevice | 设置启动设备 |
ipmcset -d clearcmos | 清除 BIOS 配置信息 |
ipmcset -d printscreen | 截取设备当前所显示的屏幕图片 |
ipmcset -d reset | 重启 openUBMC 系统 |
ipmcset -d restore | 恢复出厂设置 |
ipmcset -d rollback | 执行手动回滚 |
ipmcset -d serialdir | 设置串口方向 |
ipmcset -d timezone | 设置时区 |
ipmcset -d upgrade | 升级固件 |
散热管理
| 命令格式 | 命令功能 |
|---|---|
ipmcget -d coolingdeviceinfo | 查询风扇或水泵的工作模式和当前转速 |
ipmcget -d faninfo | 查询风扇的工作模式和当前转速 |
ipmcset -d coolinglevel | 设置散热设备转速级别 |
ipmcset -d coolingmode | 设置散热设备模式(手动/自动/混合) |
ipmcset -d fanlevel | 设置风扇运行速度 |
ipmcset -d fanmode | 设置风扇的运行模式 |
SNMP Trap
| 命令格式 | 命令功能 |
|---|---|
ipmcget -t trap -d mode | 查询 SNMP Trap 模式 |
ipmcget -t trap -d severity | 查询 Trap 发送严重级别 |
ipmcget -t trap -d state | 查询 Trap 启用状态 |
ipmcget -t trap -d trapiteminfo | 查询 Trap 条目信息 |
ipmcget -t trap -d user | 查询 SNMP Trap 用户 |
ipmcget -t trap -d version | 查询 SNMP Trap 版本 |
ipmcset -t trap -d address | 设置 Trap 目标地址 |
ipmcset -t trap -d community | 设置 SNMP Trap 团体名 |
ipmcset -t trap -d mode | 设置 SNMP Trap 模式 |
ipmcset -t trap -d port | 设置 Trap 端口号 |
ipmcset -t trap -d severity | 设置 Trap 发送严重级别 |
ipmcset -t trap -d state | 设置 Trap 启用状态 |
ipmcset -t trap -d user | 设置 SNMP Trap 用户 |
ipmcset -t trap -d version | 设置 SNMP Trap 版本 |
USB 管理
| 命令格式 | 命令功能 |
|---|---|
ipmcget -t usbmgmt -d info | 查询 USB 管理服务信息 |
ipmcset -t usbmgmt -d state | 设置 USB 管理服务状态 |
用户管理
虚拟媒体
| 命令格式 | 命令功能 |
|---|---|
ipmcget -t vmm -d info | 查询虚拟介质信息 |
ipmcset -t vmm -d connect | 挂载文件到虚拟光驱 |
ipmcset -t vmm -d disconnect | 断开虚拟光驱的连接 |
VNC
| 命令格式 | 命令功能 |
|---|---|
ipmcget -t vnc -d info | 查询 VNC 信息 |
ipmcset -t vnc -d keyboardlayout | 设置 VNC 键盘布局 |
ipmcset -t vnc -d ssl | 设置 VNC SSL 加密 |
ipmcset -t vnc -d timeout | 设置 VNC 超时时间(分钟) |