BMC CLI 接口总览
更新时间: 2026/07/28
在Gitcode上查看源码

修订记录

VersionDateDescription
1.02026/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 -d minimumpasswordage查询密码最短使用期限
ipmcget -d notimeoutstate查询 CLI 会话不休眠状态
ipmcget -d passwordcomplexity查询密码复杂度检查启用状态
ipmcget -d sshpasswordauthentication查询 SSH 密码认证状态
ipmcget -d userlist查询所有用户信息
ipmcget -t user -d list查询所有用户信息
ipmcget -t user -d osadminprivilege查询主机侧管理员权限启用状态
ipmcget -t user -d passwordcomplexity查询密码复杂度检查启用状态
ipmcget -t user -d passwordpattern查询密码复杂度校验正则表达式
ipmcget -t user -d passwordrulepolicy查询密码复杂度检查模式
ipmcget -t user -d usermgmtbyhost查询主机侧用户管理状态
ipmcset -d adduser添加用户
ipmcset -d deluser删除用户
ipmcset -d emergencyuser设置紧急用户
ipmcset -d minimumpasswordage设置密码最短使用期限
ipmcset -d password修改用户密码
ipmcset -d passwordcomplexity设置密码复杂度检查启用状态
ipmcset -d privilege设置用户权限
ipmcset -d sshpasswordauthentication设置 SSH 密码认证状态
ipmcset -t user -d addpublickey添加 SSH 公钥
ipmcset -t user -d delpublickey删除 SSH 公钥
ipmcset -t user -d firstloginpolicy设置用户首次登录密码重置策略
ipmcset -t user -d interface设置用户登录接口
ipmcset -t user -d lock锁定指定的用户
ipmcset -t user -d osadminprivilege设置主机侧管理员权限启用状态
ipmcset -t user -d passwordcomplexity设置密码复杂度检查启用状态
ipmcset -t user -d passwordpattern设置密码复杂度校验正则表达式
ipmcset -t user -d passwordrulepolicy设置密码复杂度检查模式
ipmcset -t user -d privilege设置用户权限
ipmcset -t user -d snmpprivacypassword设置指定用户使用 SNMPv3 连接 iBMC 的数据加密密码
ipmcset -t user -d state启用/禁用用户
ipmcset -t user -d unlock解锁被手动锁定或因密码重试次数用完而锁定的用户
ipmcset -t user -d usermgmtbyhost设置主机侧用户管理功能
ipmcset -t user -d weakpwddic设置弱口令字典认证功能的使能状态
ipmcset -t vnc -d password设置 VNC 密码

虚拟媒体

命令格式命令功能
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 超时时间(分钟)