lsenclosurebattery

使用 lsenclosurebattery 命令可显示有关这些电池的信息。电池位于节点容器中。

语法

lsenclosurebattery [ -nohdr ] [ -filtervalueattribute_value ] [ -filtervalue? ] [ -delim delimiter ] [ [ -batterybattery_id ] enclosure_id ]

参数

-nohdr

（可选）缺省情况下，将在简明样式视图中显示每个数据列的标题，在详细样式视图中显示每个数据项的标题。-nohdr 参数用于禁止显示这些标题。

Note: 如果没有要显示的数据，那么不会显示标题。

-filtervalueattribute=value

（可选）指定一个或多个过滤器的列表。仅返回值与过滤器属性值匹配的对象。如果指定了容量，那么还必须包含单位。

Note: 某些过滤器允许您在输入命令时使用通配符。使用 CLI 时，应该遵循以下有关使用通配符的规则：

通配符为星号 (*)。
命令最多可包含一个通配符。
使用通配符时，必须用双引号 ("") 将过滤器条目括起来，如下所示：
```
lsenclosurebattery -filtervalue "battery_id=1"
```

-filtervalue?

（可选）显示 -filtervalueattribute=value 参数的有效过滤器属性的列表：

battery_id
charging_status
enclosure_id
end_of_life_warning
percent_charged
recondition_needed
status

-delimdelimiter

（可选）缺省情况下，简明视图中的所有数据列都以空格分隔。每列的宽度设置为每个数据项的最大宽度。在详细视图中，每个数据项各占一行，如果显示标题，将用空格来分隔数据与标题。-delim 参数会覆盖此行为。-delim 参数的有效输入为一个单字节字符。如果在命令行中输入 -delim :，那么在简明视图中将用冒号字符 (:) 分隔所有数据项；例如，不会出现列间距。在详细视图中，数据与标题间以指定的定界符分隔。

-batterybattery_id

（可选）提供指定电池的详细视图。仅当已指定了机柜时有效。

enclosure_id

（可选）列出指定机柜的电池。

描述

该命令显示有关位于节点容器中的电池的信息。简明视图中，为每个机柜中的每个电池插槽显示一条线，而与插槽中是否存在电池无关。不会显示扩展机柜的电池。

下表显示了可能的输出。

Table 1. lsenclosurebattery 输出
属性	描述
enclosure_id	指示包含电池的机柜的标识。
battery_id	表示机柜中的电池。
status	标识电池的状态： `online` 指示电池存在且正常工作。 `degraded` 指示电池存在但未正常工作。 `offline` 指示检测不到电池。
charging_status	标识电池的充电状态： `charged` 指示电池已充满。 `charging` 指示电池正在充电。 `discharging` 指示电池电压下降（使用时间缩短）。 `idle` 指示电池当前未在充电或放电，但不是满电状态。 `reconditioning` 指示电池通过放电来进行自我调整，并且正在重新充电。 Important: 调整每三个月执行一次，每次需要 12 到 48 小时。在此操作期间将对电池进行保护。
recondition_needed	指示电池需要调整，或必须尽快启动调整。 Remember: 如果一直出现此消息，那么可能存在阻止调整启动的错误。
percent_charged	指示电池电量（百分比）。
end_of_life_warning	标识电池寿命终止（使用警告声）。值为 `yes` 和 `no`。 Important: 请更换电池。
FRU_part_number	标识电池的 FRU 部件号。
FRU_identity	指示 11S 编号（制造部件号与序列号的组合）。
firmware_level	安装在电池上的微码映像版本。
error_sequence_number	指示此对象的最高优先级错误的错误日志（或事件日志）编号。该输出字段通常为空白。但是，如果出现问题（例如，状态为 `degraded`），那么将会包含该错误事件的序号。
remaining_charge_capacity_mAh	指示电池的剩余电量，以毫安/小时 (mAh) 计算。 Note: 该字段针对系统之外的其他任何系统都包含空白值。
full_charge_capacity_mAh	指示电池充满电之后的电量，以 mAh 为单位（随着电池的使用，该值会逐渐减少）。 Note: 该字段针对系统之外的其他任何系统都包含空白值。
compatibility_level	指示电池驱动程序软件必须支持该级别以使用电池进行操作 - 此值来源于电池重要产品数据（VPD）。 Note: 该字段针对系统之外的其他任何系统都包含空白值。
last_recondition_timestamp	指示上次成功校准气体压力表的系统时间戳记，格式为 `YYMMDDHHMMSS`，其中： `Y` 代表年份（第一个）`M` 代表月份 `D` 代表日期 `H` 代表小时（第二个）`M` 代表分钟 `S` 代表秒 Note: 该字段针对系统之外的其他任何系统都包含空白值。
powered_on_hours	指示电池位于已供电节点中的小时数（不必在同一节点上）。 Note: 该字段针对系统之外的其他任何系统都包含空白值。
cycle_count	指示电池上执行的充电或放电周期数。 Note: 该字段针对系统之外的其他任何系统都包含空白值。

简明调用示例

lsenclosurebattery 1

生成的输出：

enclosure_id battery_id status charging_status recondition_needed percent_charged end_of_life_warning 
1            1          online idle            no                 100             no                  
1            2          online idle            no                 100             no

详细调用示例

lsenclosurebattery -battery 1 1

生成的输出：

enclosure_id 1
battery_id 1
status online
charging_status idle
recondition_needed no
percent_charged 100
end_of_life_warning no
FRU_part_number 31P1807
FRU_identity 11S00AR085YM30BG42R04P
firmware_level 105:1
error_sequence_number remaining_charge_capacity_mAh 3477
full_charge_capacity_mAh 3795
compatibility_level 1
last_recondition_timestamp 140528045617
powered_on_hours 1162
cycle_count 10