命令行界面指南

UPSNetworkManagementCard2AP9630、AP9631、AP9635990-4879J-03706/2020施耐德电气法律免责声明施耐德电气不保证本手册所提供信息的权威性、正确性或完整性.
本出版物并不是要代替详细说明操作步骤的、特定地点专用的开发计划.
因此,对于因使用本出版物而导致的损坏、违规、错误安装、系统故障或任何其他问题,施耐德电气不承担任何责任.
本出版物中所包含的信息是按原样提供的,整理这些信息仅用于评估数据中心的设计与结构之目的.
本出版物由施耐德电气依照诚信原则编制.
然而,本出版物所包含的信息的完整性或准确性未得到任何明示或暗示的说明或担保.
对于因使用或无能力使用本出版物或内容而导致、引发或相关的任何直接、间接、后果性、惩罚性、特殊或连带的损害赔偿(包括但不限于业务、合同、收入、数据、信息损失或业务中断带来的损害赔偿),即使施耐德电气已明确被告知出现此类损害赔偿的可能性,施耐德电气或其任何母公司、子公司或附属公司以及其各自的高管、董事或员工对此不承担任何责任.
施耐德电气保留随时更改或更新本出版物内容或其格式的权利,恕不另行通知.
内容(包括但不限于软件、音频、视频、文本和照片)的版权、知识产权以及所有其他专有权利均归施耐德电气或其许可人所有.
所有未在此内容中明确授予用户的权利,施耐德电气将予以保留.
施耐德电气未向获取此信息的人员授予或分配任何形式的权利,亦不应转让这些权利.
不得以整体或部分形式转售本出版物.
1UPS网络管理卡2CLI用户指南命令行界面(CLI)如何登录概述若要访问命令行界面,您可以通过本地串行或远程(Telnet或SSH)的方式连接到与网络管理卡(NMC)处于同一网络的计算机.
若要访问本CLI指南中详细介绍的命令行界面,网络管理卡必须已安装Smart-UPS或单相Symmetra固件,且网络管理卡必须安装在Smart-UPS或单相Symmetra型号UPS中.
有关与网络管理卡兼容的UPS型号的详细信息,请参阅www.
apc.
com/support上的知识库文章FA237786.
使用区分大小写的用户名和密码登录(默认情况下超级用户或管理员的用户名和密码分别为apc和apc).
设备用户的默认用户名是device.
只读用户不能访问命令行界面.
注意:在v6.
8.
0及更高版本中,首次使用超级用户帐户连接到NMC时,系统将提示您输入新密码.
安全锁定.
如果有效用户名的密码无效,且连续输入次数达到在NMCWeb界面中所指定的次数(配置>安全>本地用户>默认设置),设备用户账户将被锁定,直到超级用户或管理员重新启用此账户.
有关这些选项的更多信息,请参阅APC网站上UPS网络管理卡2的《用户指南》(针对AP9630、AP9631、AP9635).
如果您忘记了用户名或密码,请参阅APC网站上《用户指南》中的"如何恢复丢失的密码".
远程访问命令行界面您可以通过Telnet或SSH访问命令行界面.
在v6.
8.
0及更高版本中,仅SSH默认为启用状态.
若要启用或禁用这些访问方法,请使用Web界面.
在配置菜单上,选择网络>控制台>访问.
还可以通过命令行界面启用或禁用Telnet或SSH访问.
请参阅第13页上的"console".
SSH用于高安全性访问.
如果Web界面使用安全性较高的TLS,则可以使用SSH访问命令行界面.
SSH会加密用户名、密码和传输的数据.
无论是通过SSH还是Telnet访问命令行界面,界面、用户帐户和用户访问权限都一样,但是要使用SSH,必须首先配置SSH并在计算机上安装SSH客户端程序.
启用SSH的同时还会启用SCP(安全拷贝),以用于安全文件传输.
使用以下示例命令通过SSH访问NMC:ssh-caes256-ctrapc@156.
205.
14.
141注意:此SSH命令适用于OpenSSH.
该命令可能因使用的SSH工具而有所不同.
Telnet用于基本访问.
Telnet通过用户名和密码提供身份验证的基本安全性,但是不具备加密的高安全性优势.
使用Telnet访问命令行界面:1.
在一台能够访问网络且安装了NMC的计算机的命令提示符中,键入telnetNMC的IP地址(例如,当NMC使用默认的Telnet端口23时,地址为telnet139.
225.
6.
133),然后按下ENTER.
2UPS网络管理卡2CLI用户指南注:此示例适用于基于命令提示符的Telnet客户端.
不同Telnet客户端的命令可能有所不同.
如果NMC使用非默认的端口号(从5000到32768),您必须根据Telnet客户端,在IP地址(或DNS名称)和端口号之间添加冒号或空格.
(这些是一般使用的命令:有些客户端不允许您指定端口作为自变量,且某些类型的Linux可能需要额外的命令).
2.
输入用户名和密码.
拨号访问命令行界面(仅限AP9635).
若要在AP9635NMC上使用调制解调器拨号访问命令行界面:1.
将有源电话线(RJ-11)连接到AP9635前面板上的调制解调器端口.
2.
在连接到调制解调器的计算机上,使用调制解调器终端软件(例如,HyperTerminal或TeraTerm等第三方终端模拟器程序)拨打为连接到AP9635卡的线缆分配的电话号码.
3.
连接时,调制解调器终端软件会打开一个命令行终端.
出现提示时,输入用户名和密码.

配置AP9635NMC调制解调器设置仅可在"配置INI"文件中进行AP9635调制解调器的配置.
有关直接编辑"配置INI"文件的详细信息,请参阅APC网站上《NMC用户指南》中的"检索和导出.
ini文件-自定义".
若要在"配置INI"文件中配置调制解调器设置:1.
在文本编辑器中打开"配置INI"文件2.
找到标题为[SystemModem]的部分,然后更新以下设置:选项自变量说明ConsoleDialInenabled|disabled启用此选项以允许远程调制解调器拨号访问命令行界面.
默认情况下为启用状态.
InitString[AT命令][&命令][MNP命令]InitString选项接受标准贺氏协议选项.
无需编辑InitString.
默认为[AT&F0E0].
Country文本字符串用于指定连接到NMC的有源电话线的拨号号码的国家/地区.
DialBackenabled|disabled启用此选项以指示NMC调制解调器在接收到拨号请求时挂断并回拨指定号码.
默认情况下,DialBack为禁用状态.
DialBackString电话号码如果已启用DialBack,此选项为NMC接收到拨号请求时要回拨的电话号码.
3UPS网络管理卡2CLI用户指南本地访问命令行界面对于本地访问,您可以使用通过控制台串行端口连接到计算机的网络管理卡访问命令行界面:1.
选择计算机上的一个串行端口,并禁用使用该端口的所有服务.
2.
将随附的串行缆线(部件号940-0299)连接到计算机上的选定端口以及NMC上的配置端口.
3.
运行终端程序(例如,HyperTerminal、PuTTY或TeraTerm等第三方终端模拟器程序),并将选定端口配置为9600bps、8个数据位、无奇偶校验、1个停止位和无数据流控制.
4.
按下ENTER.
在提示符上,输入用户名和密码.
主屏幕主屏幕示例下面是您登录网络管理卡(NMC)上的命令行界面时显示的屏幕示例.
信息和状态字段主屏幕信息字段以下两个字段表示美国电力转换公司操作系统(AOS)和应用程序(APP)固件版本.
应用程序固件名称表示通过该NMC与网络相连的设备.
在上面的例子中,NMC使用SymmetraUPS的应用程序固件.
NetworkManagementCardAOSvx.
x.
xSymmetraAPPvx.
x.
xSchneiderElectricNetworkManagementCardAOSvx.
x.
x(c)Copyright2019AllRightsReservedSymmetraAPPvx.
x.
xName:TestLabDate:10/30/2018Contact:DonAdamsTime:5:58:30Location:Building3User:SuperUserUpTime:0Days,21Hours,21MinutesStat:P+N4+N6+A+NetworkProtocolsConfigurationSummaryProtocol|Status|Protocol|Status|Protocol|StatusHTTP|disabled|HTTPS|enabled|FTP|enabledTelnet|disabled|SSH/SFTP|enabled|SNMPv1|enabledSNMPv3|disabled|ModbusTCP|enabled||IPv6|disabled|IPV4|enabled|Ping|enabledTypeforcommandlistingUsetcpipcommandforIPaddress(-i),subnet(-s),andgateway(-g)apc>4UPS网络管理卡2CLI用户指南以下三个字段表示系统名称、联系人和NMC的位置.
(通过在用户界面中选择管理选项卡,在顶部菜单栏中选择常规,然后在左侧导航菜单中选择标识,可设置这些值.

)Name:TestLabContact:DonAdamsLocation:Building3UpTime字段报告NMC管理界面自上次开启或重置以来运行的时长.
UpTime:0Days21Hours21Minutes以下两个字段报告您登录的日期和时间.
Date:10/30/2018Time:5:58:30User字段报告您是通过超级用户、管理员、设备管理员、仅网络帐户,还是只读帐户登录的.

以"设备管理员"(等同于用户界面中的"设备用户")身份登录时,您可以访问事件日志、配置某些UPS设置以及查看活动警报的数量.
User:SuperUser主屏幕状态字段Stat字段报告NMC状态.
中间状态会根据您运行的是IPv4、IPv6或这两者而变化,详见下面第二个表格.
Stat:P+N+A+如果未显示P+,请访问http://www.
apc.
com/site/support/联系客户支持.
P+操作系统(AOS)功能正常.
仅IPv4仅IPv6IPv4和IPv6*说明N+N6+N4+N6+网络功能正常.
NN6N4N6BOOTP请求周期正在运行.
N–N6–N4–N6–NMC未连接到网络.
N!
N6!
N4!
N6!
其他设备正在使用NMC的IP地址.
*N4和N6值可能互不相同:例如,您可以设置N4–N6+.
A+应用程序功能正常.
A–应用程序校验和错误.
A应用程序正在初始化.
A!
应用程序与AOS不兼容.
5UPS网络管理卡2CLI用户指南如何使用命令行界面概述使用命令行界面上的诸多选项可以配置网络设置和管理UPS及其网络管理卡(NMC).
如何输入命令在命令行界面,使用命令配置NMC.
若要使用某个命令,请键入该命令,并按下ENTER.
命令和自变量可以以小写字母、大写字母或者大小写字母输入.
选项区分大小写.
使用命令行界面时,您也可以执行下列操作:键入,并按下ENTER,根据您的帐户类型,查看可用的命令.
若要获得有关特定命令的功能和语法信息,请键入该命令、空格和或help字样.
例如,若要查看RADIUS配置选项,键入:radius或radiushelp按下向上箭头键可查看当前会话中最近输入的命令.
使用向上和向下箭头键可滚动查看最多十个先前输入的命令清单.
至少键入某个命令的一个字母,并按下TAB键,可翻看与您在命令行键入的文本相匹配的有效命令清单.
键入ups-st可查看UPS的状态.
键入exit或quit可关闭命令行界面的连接.
命令语法项目说明-选项前面的连字符.
选项的定义包含在尖括号中.
例如:-pw[]如果某个命令接受多个选项或某个选项接受相互独立的自变量,则可以将值包含在括号中.
|包含在括号或尖括号中的项目之间的垂线表示项目之间相互独立.
您必须使用其中一个项目.
6UPS网络管理卡2CLI用户指南语法示例支持多个选项的命令:user-n-pw在此,user命令接受指定用户名的选项-n,和更改密码的选项-pw.
例如,要将密码更改为XYZ,则键入:user-napc-pwXYZ注:远程更改密码时,超级用户也需要当前密码.
请参阅"User"部分.
选项接受相互独立自变量的命令:alarmcount-p[all|warning|critical]在本示例中,选项-p只接受三个自变量:all、warning或critical.
例如,若要查看活动的严重警报数量,键入:alarmcount-pcritical如果您键入一个未指定的自变量,该命令无效.
命令响应代码命令响应代码启用脚本操作,能可靠地检测错误条件,而不必与错误消息文本匹配.

CLI使用下列格式报告所有命令操作:E[0–9][0–9][0–9]:错误消息代码错误消息E000成功E001成功签发E002系统需要重新启动,所作的修改方可生效E100命令无效E101命令未找到E102参数错误E103命令行错误E104用户级拒绝E105命令预填E106数据不可用E107失去与UPS的串行通信E108由于无效/加密的证书,EAPoL已禁用7UPS网络管理卡2CLI用户指南命令说明下列命令和选项的可用性视UPS设备而异.
使用权限:超级用户、管理员、设备用户说明:查看您的帐户类型可用的所有CLI命令清单.
若要查看特定命令的帮助文本,请键入该命令和一个问号.
示例:若要查看alarmcount命令接受的选项清单,键入:alarmcountabout访问权限:超级用户、管理员、设备用户、仅网络、只读说明:查看硬件和固件信息.
此信息在故障诊断时很有帮助,您可以用它来确定网站是否有可用的更新固件.
alarmcount使用权限:超级用户、管理员、设备用户、只读说明:示例:若要查看所有活动的警告警报,键入:alarmcount-pwarning选项自变量说明-pall查看NMC报告的活动警报的数量.
有关警报的信息记录在事件日志中.
warning查看活动的警告警报的数量.
critical查看活动的严重警报的数量.
8UPS网络管理卡2CLI用户指南bacnet使用权限:超级用户、管理员、设备用户说明:查看和定义BACnet设置.
有关通过BACnet提供UPS数据点的更多信息,请参阅APC网站上提供的BACnet应用程序地图.
选项自变量说明-Senable|disable选择该选项以启用或禁用BACnet.
如果禁用BACnet,则不能通过BACnet访问NMC.
默认情况下,BACnet为禁用状态.
注意:在v6.
8.
0及更高版本中,在设置设备通信控制密码(-pw)之前,无法启用BACnet.
-d0-4194303此BACnet设备的唯一标识符,用于寻址设备.
-n此BACnet设备的名称,在BACnet网络上必须是唯一的.
默认设备名称是"BACn"+NMCMAC地址的最后八位数字.
最小长度为1个字符,最大长度为150个字符,允许使用特殊字符.
-t1000-30000指定APDU超时;NMC将等待BACnet请求响应的毫秒数.
缺省值是6000.
-r0-10指定APDU重试;在中止请求之前,NMC将做出的BACnet请求尝试的数量.
缺省值是3.
-pwBACnet客户端使用设备通信控制服务来命令远程设备(例如,启用了BACnet的NMC)停止发起或停止响应指定持续时间内的所有APDU(设备通信控制服务除外).
该服务可用于诊断目的.
指定设备通信控制密码,以确保BACnet客户端无法控制NMC的BACnet通信,而无需先提供此处设置的密码.
密码必须在8到20个字符之间,并且必须包含:数字.
大写字符.
小写字符.
特殊字符.
建议在首次启用BACnet时更新密码.
无需知道当前密码即可更新密码.
BACnetIP选项:-o47808,5000-65535指定NMC用来发送和接收BACnet/IP消息的UDP/IP端口.
注:启用了BACnet/IP的NMC地址被定义为NMC和本地端口的IP地址.
-fdreenable|disable指定启用以使用BACnet广播管理设备(BBMD)注册NMC.
注:如果NMC的子网上当前没有BBMD,或者NMC使用不同的本地端口连接到BBMD,则需要将NMC注册为具有BBMD的外部设备.
有关外部设备注册的更多信息,请参阅APC网站.
-ripIPaddressBACnet广播管理设备的IP地址或完全限定域名(FQDN),NMC卡将在此注册.
9UPS网络管理卡2CLI用户指南示例:bacnetE000:SuccessEnabled:yesDeviceID:1013Devicename:BACnB7D7E5F2NetworkProtocol:BACnet/IPAPDUtimeout(ms):6000APDUretries:3IPPort:47808(0xBAC0)RegistrationEnabled:noRegistrationStatus:ForeigndeviceregistrationinactiveRegistrationBBMD:0.
0.
0.
0RegistrationBBMDport:47808(0xBAC0)RegistrationTTL:7200boot访问权限:超级用户、管理员、仅网络说明:定义NMC如何获得其网络设置,包括IP地址、子网掩码和默认网关.
然后配置BOOTP或DHCP服务器设置.
-rpo5000-65535BBMD端口,NMC卡将在此注册.
-fdrttl1-65535BBMD将NMC保留为注册设备的秒数(生存时间).
如果NMC在此时间之前没有重新注册,则BBMD将从其外部设备表中删除,NMC将不再能够通过BBMD发送和接收广播消息.
选项自变量说明-bdhcp|bootp|manual定义开启、重置或重启NMC时如何配置TCP/IP设置.
-cenable|disable仅限dhcp启动模式.
启用或禁用DHCP服务器提供APCcookie的要求.
这三个设置的默认值一般不需要更改:-vAPC.
-i用于在网络上唯一识别NMC的MAC地址.
-u应用程序固件模块的名称.
选项自变量说明10UPS网络管理卡2CLI用户指南示例:若要使用DHCP服务器获得网络设置:1.
键入boot-bdhcp2.
启用DHCP服务器提供APCcookie的要求:boot-cenablebye访问权限:超级用户、管理员、设备用户、仅网络、只读说明:从命令行界面会话中退出.
这与exit或quit命令的作用相同.
示例:byeConnectionClosed-Byecd访问权限:超级用户、管理员、设备用户、仅网络、只读说明:导航至NMC目录结构中的某个文件夹.
示例1:若要更改为ssh文件夹,并确认SSH安全证书已上传至NMC:1.
键入cdssh,并按下ENTER.
2.
键入dir,并按下ENTER,将列出SSH文件夹中保存的文件.
示例2:若要返回先前的目录文件夹,键入:cd.
.
cipher访问权限:超级用户、管理员说明:启用或禁用WebUI会话的加密算法.
您无法直接从Web界面启用或禁用此类算法.
启用或禁用算法后,您必须重新启动NMC,才能使更改生效.
算法分为三类:身份验证算法、分组加密算法和MAC算法.
另外,还会列出可用和已分组加密包.
禁用类别中的唯一算法会阻止所有TLS会话,且HTTPS访问可能不会按您的浏览器及其配置运作.
注:在v6.
7.
2及更高版本中,您必须显式启用或禁用算法.
选项自变量说明-aesenable|disable启用或禁用高级加密标准(AES).
-dhenable|disable启用或禁用Diffie-Hellman(DH).
-rsakeenable|disable启用或禁用RSA密钥交换.
-rsaauenable|disable启用或禁用RSA身份验证.
-sha1enable|disable启用或禁用安全哈希算法1(SHA-1).
-sha2enable|disable启用或禁用安全哈希算法2(SHA-2).
-ecdheenable|disable启用或禁用椭圆曲线Diffie-Hellman交换(ECDHE).
11UPS网络管理卡2CLI用户指南示例:禁用AES.
cipher-aesdisableE000:SuccessRebootrequiredforchangetotakeeffect.
cfgshutdn使用权限:超级用户、管理员、设备用户说明:配置关闭参数:您使用它可以显示和配置UPS关闭延迟、UPS恢复延迟、UPS低电持续时间、UPS休眠时间、UPS最低电池电量以及UPS最短恢复运行时间.
这些选项并非所有UPS设备都提供.
示例:cfgshutdn-allE000:SuccessLowBatteryDuration:4minSleepTime:0.
0hr选项自变量说明-all显示此UPS适用的所有关闭参数.
-sd000|090|180|270|360|450|540|630设置关闭延迟(单位:秒).
-lo02|05|08|11|14|17|20|23设置低电持续时间(单位:分钟).
-rd000|060|120|180|240|300|360|420设置UPS恢复延迟(单位:秒),即UPS重新开启前的延迟时间.
-rrt0–3600设置最短恢复运行时间(单位:秒),即UPS重新开启前电池的运行时间必须达到此值才能支持负载.
-sl0.
0–359.
9设置休眠时间(单位:小时).
自变量可以是0.
0到359.
9之间的任意数值.
-rsc00|15|30|45|60|75|90设置最低电池电量,以占满电量的百分比表示.
12UPS网络管理卡2CLI用户指南cfgpower使用权限:超级用户、管理员、设备用户说明:配置电源参数:您使用它可以显示和配置转换点、灵敏度和输出电压.
这些选项并非所有UPS设备都提供.
示例:cfgpower-allE000:SuccessLowTransferVoltage:106VACHighTransferVoltage:127VACSensitivity:Normalclrrst使用权限:超级用户、管理员定义:清除网络接口重置原因.
请参阅第20页上的"lastrst".
选项自变量这些值因不同设备而异.
说明-all显示此UPS适用的所有电源参数.
-l97–106设置低转换点(单位:VAC).
-h127–136设置高转换点(单位:VAC).
-ov100|120|110|设置插座电压(单位:VAC).
-sNormal|Reduced|Low使用这三个自变量之一设置灵敏度.
-bu127|130|133|136|139|142|145|148设置旁路电压上限(单位:VAC);当电压超过此值时,设备将变为旁路.
-bl086|088|090|092|094|096|098|100设置旁路电压下限(单位:VAC);当电压低于此值时,设备将变为旁路.
-rdaNever|n+1|n+2设置在可用冗余电源低于n+1或n+2时触发的警报.
键入Never,以防止在响应冗余丢失时触发警报.
该选项仅适用于Symmetra型号UPS.
-ldaNever|01.
0|02.
0|03.
0|04.
0|05.
0|06.
0|07.
0|08.
0|09.
0|10.
0|12.
0|14.
0|16.
0设置在负载超过指定的kVA负载级别时触发的警报.
键入Never,以防止在响应负载级别变更时触发警报.
该选项仅适用于Symmetra型号UPS.
-rtaNever|005|010|015|030|045|060|120|180|240|300|360|420|480设置在可用电池运行时间低于指定分钟数时触发的警报.
可用电池运行时间是指UPS在电池供电时能够支持当前负载的分钟数.
键入Never,以防止在响应电池运行时间降低时触发警报.
该选项仅适用于Symmetra型号UPS.
13UPS网络管理卡2CLI用户指南console使用权限:超级用户、管理员、仅网络说明:定义用户是使用Telnet还是通过以加密形式传输用户名、密码和数据来提供保护的安全接壳(SSH)访问命令行界面.
为了更加安全,您可以修改Telnet或SSH端口的设置.
也可以禁用网络对命令行界面的访问.
注意:在v6.
8.
0及更高版本中,Telnet默认为禁用状态,而SSH默认为启用状态.
示例1:若要启用对命令行界面的Telnet访问,键入:console-t示例2:若要将SSH端口更改为5000,键入:console-ps5000date使用权限:超级用户、管理员定义:配置NMC使用的日期.
若要配置NTP服务器,以为NMC定义日期和时间,请参阅《用户指南》.
示例1:若要使用yyyy-mm-dd格式显示日期,键入:date-fyyyy-mm-dd示例2:若要使用前一示例中配置的格式将日期定义为2009年10月30日,键入:date-d"2009-10-30"示例3:若要将时间定义为5:21:03p.
m.
,键入:date-t17:21:03选项自变量说明-senable|disable启用或禁用SSH.
启用SSH会同时启用SCP.
-tenable|disable启用或禁用Telnet.
-pt指定用于与NMC通信的Telnet端口号(默认为23).
其他范围为5000–32768.
-ps指定用于与NMC通信的SSH端口号(默认为22).
其他范围为5000–32768.
-b2400|9600|19200|38400配置串行波特率(默认为9600).
选项自变量说明-d设置当前日期.
使用date-f命令指定的日期格式.
-t配置当前时间的小时、分钟和秒数.
使用24小时时钟格式.
-fmm/dd/yy|dd.
mm.
yyyy|mmm-dd-yy|dd-mmm-yy|yyyy-mm-dd选择在该用户界面显示所有日期的数字格式.
每个字母m(月)、d(日)和y(年)代表一个数位.
单个数位的日和月通过在前面加一个零来表示.
-z使用格林威治标准时间设置时差,以便指定您的时区.
这样您可以与不同时区中的人员保持同步.
14UPS网络管理卡2CLI用户指南delete使用权限:超级用户、管理员说明:删除文件系统中的文件.
(若要删除事件日志,请参阅《用户指南》.
)示例:若要删除文件:1.
导航至包含该文件的文件夹.
例如,若要导航至logs文件夹,键入:cdlogs2.
若要查看logs文件夹中的文件,键入:dir3.
键入deletedetbat该命令并非适用于所有UPS设备.
带SRT前缀的某些UPS设备有不同的选项可供使用.
使用权限:超级用户、管理员、设备用户说明:查看详细的UPS电池信息.
自变量说明键入要删除的文件的名称.
选项自变量说明-all显示所有电池信息.
-f组固件版本.
-t组温度.
-pe组电池状态.
-s组或单元运行状况.
-ph电池组运行状况.
注:此选项仅适用于带有SRT前缀的某些UPS设备.
-rd组或单元的建议更换电池日期.
-pr电池组建议更换电池日期.
注:此选项仅适用于带有SRT前缀的某些UPS设备.
-id组或单元的电池安装日期(以当前日期格式显示).
-pi以当前日期格式显示的电池组安装日期.
注:此选项仅适用于带有SRT前缀的某些UPS设备.
-ce组或单元电池状态.
15UPS网络管理卡2CLI用户指南示例:detbat-allE000:SuccessFirmwareRevision(IP):BMC12.
5Temperature(IP):26.
00CPackStatus(IP):NoErrorsHealth(IP,C1):BatteryLifeOKPredictedReplacementDate(IP,C1):07/02/2019InstallationDate(IP,C1):02/12/2015Status(IP,C1):OKdetstatus使用权限:超级用户、管理员、设备用户说明:查看UPS的详细状态.
另请参阅第32页上的"ups"中的-st选项.
示例:detstatus-rtE000:SuccessRuntimeRemaining:9hr22min30sec选项说明-all显示此UPS适用的所有状态信息.
-rt剩余运行时间,以小时和分钟计.
-ssUPS状态摘要:市电/电池模式等.
-socUPS电池电量,以占满电量的百分比表示.
-om输出测量值:电压、频率、瓦特百分比、VA百分比、电流.
-im输入测量值:电压和频率.
-bat电池电压.
-tmpUPS的内部温度.
-dg诊断测试结果:自检结果和日期、校准结果和日期.
16UPS网络管理卡2CLI用户指南dir访问权限:超级用户、管理员、设备用户、仅网络、只读说明:查看NMC上保存的文件和文件夹.
示例:dirE000:Success3069184Jun2818:07apc_hw05_aos_664.
bin3031604Jul3019:05apc_hw05_sumx_664.
bin45000Aug1710:54config.
ini0May142018db/0May142018ssl/0May142018ssh/0May142018logs/0May142018sec/0May142018dbg/0May142018fwl/0May142018email/0May142018lang/0May142018tmp/0May142018upsfw/0May142018rms/0May142018scg/dns使用权限:超级用户、管理员说明:配置和显示手动域名系统(DNS)设置.
选项自变量说明-OMenable|disable覆盖手动DNS.
-yenable|disable同步系统和主机名.
这与使用"system-s"的效果一样.
-p设置主DNS服务器.
-s设置次DNS服务器.
-d设置域名.
-n设置域名IPv6.
-h设置主机名.
17UPS网络管理卡2CLI用户指南示例:dns-OME000:SuccessOverrideManualDNSSettings:enabledeapol访问权限:超级用户、管理员说明:配置EAPoL(802.
1X安全)设置.
示例1:要显示eapol命令的结果:apc>eapolE000:SuccessActiveEAPoLSettingsStatus:enabledSupplicantName:NMC-SupplicantPassphrase:CAfileStatus:ValidCertificatePrivateKeyStatus:ValidCertificatePublicKeyStatus:ValidCertificateResult:Success示例2:要启用EAPoL:apc>eapol-SenableE000:SuccessRebootrequiredforchangetotakeeffect.
email使用权限:超级用户、管理员、仅网络用户说明:使用以下命令为NMC用来发送事件通知的电子邮件配置参数.
选项自变量说明-Senable|disable启用或禁用EAPoL.
-n设置请求者名称.
-p设置私钥密码.
选项自变量说明-g[n]启用(默认)或禁用发送电子邮件给收件人.
-t[n]收件人的电子邮件地址.
18UPS网络管理卡2CLI用户指南-o[n](格式)长格式包含设备名称、位置、联系人、IP地址、序列号、日期和时间、事件代码以及事件说明.
短格式仅提供事件说明.
-l[n]发送电子邮件所使用的语言.
这取决于安装的语言包.
-r[n](路由)设置SMTP服务器选项:Local(建议):如果您的SMTP服务器位于内部网络上,或已设置用于您的电子邮件域,则选择此选项.
选择此设置可限制延迟和网络中断.
如果选择此设置,您必须同时启用在设备的SMTP服务器转发,并设置一个特殊的外部电子邮件帐户来接收转发的电子邮件.
注:做出这些更改前,请咨询您的SMTP服务器管理员.
Recipient:此设置可将电子邮件直接发送给收件人的SMTP服务器,它由"收件人:"地址的域MX记录查询来确定.
设备仅尝试发送电子邮件一次.
网络中断或繁忙的远程SMTP服务器可能会导致超时,并使电子邮件丢失.
此设置无需在SMTP服务器上执行其他管理任务.
Custom:此设置可使每个电子邮件收件人都具有其独有的服务器设置.
这些设置不受-s[n]选项的设置影响.
-f[n]所发送电子邮件的发件人:字段中由NMC使用的发件人电子邮件地址.
-s[n]本地SMTP服务器的IPv4/IPv6地址或DNS名称.
如果-r[n]选项设置为Local,则使用此选项.
-p[n]SMTP端口号,默认为25.
替代端口:465、587、2525、5000-32768.
-a[n](身份验证)如果SMTP服务器需要进行身份验证,则启用此选项.
-u[n]如果您的邮件服务器需要身份验证,请在此处键入您的用户名和密码.
-w[n]-e[n](加密)None:SMTP服务器不要求也不支持加密.
IfSupported:SMTP服务器发出支持STARTTLS的公告,但不要求加密连接.
STARTTLS命令在发出公告后发送.
Always:SMTP服务器要求STARTTLS命令在连接到它时发送.
Implicit:SMTP服务器只接受已加密的连接.
无STARTTLS消息发送至服务器.
-c[n](所需证书)此选项只应在您的组织的安全策略不允许TLS连接的隐式信任时启用.
启用后,必须将有效的根CA证书加载到NMC才能发送加密电子邮件.
-i[n]此字段取决于NMC上安装的根CA证书和是否需要根CA证书.
文件的扩展名必须为.
crt或.
cer.
n=电子邮件收件人编号(1、2、3或4)指定由收件人编号标识的电子邮件收件人.
选项自变量说明19UPS网络管理卡2CLI用户指南示例:若要使用本地SMTP服务器将电子邮件从地址sender@apc.
com发送到电子邮件地址为recipient1@apc.
com的电子邮件收件人1,请输入以下内容:email-g1enable-r1local-t1recipient1@apc.
com-f1sender@apc.
comE000:Successeventlog访问权限:超级用户、管理员、设备用户、仅网络、只读说明:查看您检索事件日志的日期和时间、UPS的状态以及连接到NMC的传感器的状态.
查看最近的设备事件及其发生的日期和时间.
使用下列按键导航事件日志:exit访问权限:超级用户、管理员、设备用户、仅网络、只读说明:从命令行界面会话中退出.
firewall访问权限:超级用户、管理员、仅网络说明:启用、禁用或配置内部NMC防火墙功能.
示例:若要启用防火墙策略文件example.
fwl,请输入以下内容:firewall-fexample.
fwlE000:Success按键说明ESC关闭事件日志,并返回命令行界面.
ENTER更新日志显示.
使用该命令可查看您最近检索和显示日志之后记录的事件.

SPACEBAR查看事件日志的下一页.
B查看事件日志的上一页.
在事件日志的主页面,该命令不可用.
D删除事件日志.
按照提示,确认或拒绝删除.
删除的事件不可恢复.
选项自变量定义-S启用或禁用防火墙.
-f要激活的防火墙策略文件的名称.
-t要测试的防火墙的名称,持续时间以分钟为单位.
-fe显示活动文件错误的列表.
-te显示测试文件错误的列表.
-c取消防火墙测试.
-r显示活动防火墙规则的列表.
-l显示防火墙活动日志.
20UPS网络管理卡2CLI用户指南format使用权限:超级用户、管理员说明:重新格式化NMC的文件系统,并清除所有安全证书、加密密钥、配置设置、事件和数据日志.

请谨慎使用该命令.
若要将NMC重置为其默认配置,请改用resetToDef命令.
ftp访问权限:超级用户、管理员、仅网络说明:启用或禁用对FTP服务器的访问.
也可以将端口设置更改为5001至32768之间任何未使用的数字,以增加安全性.
注意:在v6.
8.
0及更高版本中,FTP默认为禁用状态.
示例:若要将TCP/IP端口更改为5001,键入:ftp-p5001help使用权限:超级用户、管理员、设备用户、仅网络、只读说明:查看您的帐户类型可用的所有CLI命令清单.
若要查看特定命令的帮助文本,请键入该命令和help.
示例1:若要查看以"设备用户"身份登录的用户可用的命令清单,键入:help示例2:若要查看alarmcount命令接受的选项清单,键入:alarmcounthelplang使用权限:超级用户、管理员、设备用户、只读用户、仅网络用户说明:正在使用的语言示例:langLanguagesenUS-Englishlastrst使用权限:超级用户、管理员说明:上次网络接口重置原因.
使用此命令的输出可在技术支持部门的指导下对网络接口问题进行故障排除.
选项自变量定义-p定义FTP服务器用于与NMC通信的TCP/IP端口(默认为21).
FTP服务器使用指定端口和比指定端口低一个号码的端口.
-Senable|disable配置对FTP服务器的访问.
21UPS网络管理卡2CLI用户指南示例:lastrst09ColdstartResetE000:Successledblink使用权限:超级用户、管理员说明:将NMC的LED状态设置为闪烁指定的时间量.
使用此命令可帮助视觉定位NMC.
参数:时间(单位:分钟)示例:ledblink2E000:Successlogzip使用权限:超级用户、管理员说明:为从NMC和UPS设备提供的日志文件创建单个压缩存档.
技术支持部门可使用此类文件解决问题.
示例:logzip-m1GeneratingfilesCompressingfilesinto/dbg/debug_ZA1752123456.
tarEmailinglogfilestoemailrecipient-1E000:Successmodbus使用权限:超级用户、管理员、设备用户说明:查看和配置Modbus参数.
选项自变量定义-m(电子邮件收件人编号(1-4))将zip文件发送到的电子邮件收件人的标识编号.
输入配置的四个可能电子邮件收件人之一的编号.
选项自变量定义-a(Modbus状态)启用或禁用Modbus串口.
1-br(波特率)设置波特率(单位:比特/秒).
1-prevent|odd|none设置奇偶校验位.
1-s(以十六进制表示的从属地址)设置十六进制Modbus从属地址.
1UPS网络管理卡2CLI用户指南22示例:modbusE000:SuccessSlaveAddress=0x1Status=ENABLEDBaudRate=9600Parity=noneTCPStatus=ENABLEDTCPPortNumber=502netstat访问权限:超级用户、管理员、仅网络说明:查看网络状态和所有活动的IPv4和IPv6地址.
示例:netstatCurrentIPinformationntp访问权限:超级用户、管理员、仅网络说明:查看和配置网络时间协议参数.
-rDef将Modbus配置重置为默认值.
-tE(ModbusTCP状态)启用或禁用ModbusTCP.
2-tP指定ModbusTCP端口号.
默认端口号为502,可设置为5000到32768之间的值.
21仅在AP9635卡上支持Modbus串口.
2在AP9630、AP9631和AP9635卡上支持ModbusTCP.
FamilymHomeTypeIPAddressStatusIPv64autoFE80::2C0:B7FF:FEEA:D325/64configuredIPv40manual10.
125.
43.
115/22configuredIPv60manual::1/128configuredIPv40manual127.
0.
0.
1/32configured选项自变量定义-OMenable|disable覆盖手动设置.
-p指定主服务器.
-s指定次服务器.
-eenable|disable启用或禁用NTP.
选项自变量定义UPS网络管理卡2CLI用户指南23示例1:若要启用覆盖手动设置功能,键入:ntp-OMenable示例2:若要指定主NTP服务器,键入:ntp-p150.
250.
6.
10ping访问权限:超级用户、管理员、设备用户、仅网络说明:确定使用您指定的IP地址或DNS名称的设备是否连接至网络.
会向地址发送四个查询.
示例:若要确定IP地址为150.
250.
6.
10的设备是否连接到网络,键入:ping150.
250.
6.
10portspeed访问权限:超级用户、管理员、仅网络说明:示例:若要配置TCP/IP端口使用100Mbps半双工通信(一次只在一个方向通信),键入:portspeed-s100Hprompt访问权限:超级用户、管理员、设备用户、仅网络说明:配置命令行界面提示符,包含或排除当前登录的用户的帐户类型.
任何用户均可更改此设置;所有用户帐户将会得到更新以使用新设置.
示例:若要在命令提示符中包含当前登录的用户的帐户类型,键入:prompt-slong-u立即通过NTP服务器更新NMC时间.
自变量说明使用xxx.
xxx.
xxx.
xxx格式键入IP地址,或键入DNS名称.
选项自变量说明-sauto|10H|10F|100H|100F定义以太网端口的通信速度.
auto命令使以太网设备能够协商以最高速度传输.
选项自变量说明-slong提示符包含当前登录的用户的帐户类型.
short提示符长度为四个字符:apc>选项自变量定义24UPS网络管理卡2CLI用户指南pwd使用权限:超级用户、管理员、设备用户、只读用户、仅网络用户说明:用于输出当前工作目录的路径.
quit访问权限:超级用户、管理员、设备用户、仅网络、只读说明:退出命令行界面会话(这与exit和bye命令的作用相同).
radius访问权限:超级用户、管理员、仅网络说明:查看现有的RADIUS设置、启用或禁用RADIUS身份验证以及最多配置两台RADIUS服务器的基本身份验证参数.
有关RADIUS服务器配置的摘要和支持的RADIUS服务器清单,请参阅APC网站上的《用户指南》.
RADIUS服务器的其他身份验证参数在NMC的用户界面上提供.
有关配置RADIUS服务器的详细信息,请参阅APC网站上的《安全手册》.
示例1:若要查看NMC的现有RADIUS设置,键入radius,并按下ENTER.
示例2:若要启用RADIUS和本地身份验证,键入:radius-aradiusLocal示例3:若要为次RADIUS服务器配置10秒超时时间,键入:radius-t210选项自变量说明-alocal|radiusLocal|radius配置RADIUS身份验证:local—禁用RADIUS.
启用本地身份验证.
radiusLocal—先RADIUS身份验证,后本地身份验证.
启用RADIUS和本地身份验证.
首先从RADIUS服务器请求身份验证.
如果RADIUS服务器没有响应或无法通过网络来访问,则使用本地身份验证.
radius—启用RADIUS.
禁用本地身份验证.
-p1-p2-o1-o2主或次RADIUS服务器的服务器名称或IP地址.
注:默认情况下,RADIUS服务器使用端口1812对用户进行身份验证.
若要使用不同的端口,在RADIUS服务器名称或IP地址末尾添加一个冒号再加上新的端口号.
NMC支持端口1812、5000-32768.
-s1-s2主或次RADIUS服务器与NMC之间的共享秘密.
-t1-t2NMC等待主或次RADIUS服务器响应的时间(单位:秒).
25UPS网络管理卡2CLI用户指南reboot访问权限:超级用户、管理员、仅网络说明:重新启动NMC的网络管理界面.
这不会影响安装NMC的设备的输出电源.
resetToDef使用权限:超级用户、管理员说明:将所有可配置参数重置为其默认值.
某些非可配置参数不可使用resetToDef进行重置,且仅可通过使用format命令格式化文件系统来从NMC中清除.
示例:若要重置对NMC的配置所作的所有更改(TCP/IP设置除外),键入:resetToDef-pkeepipsession使用权限:超级用户、管理员说明:记录登录用户、接口、地址、时间和ID.
示例:session选项自变量说明-pall|keepip注意:这会将所有可配置参数重置为其默认值.
重置对配置所作的所有更改,包括事件操作、设备设置以及TCP/IP配置设置(可选).
选择keepip可保留用于确定NMC如何获取其TCP/IP配置值的设置,默认为DHCP.
选项自变量说明-d(删除)删除具有指定会话ID的当前用户会话.
-m(启用多用户)启用时,可允许两个或更多个用户同时登录.
禁用时,每次只允许一个用户登录.
-a(远程身份验证覆盖)NMC支持在服务器上进行RADIUS密码存储.
启用"远程身份验证覆盖"可允许本地用户使用存储于本地NMC上的用户名和密码登录.
UserInterfaceAddressLoggedInTimeIDapcTelnet10.
169.
118.
10000:00:031926UPS网络管理卡2CLI用户指南smtp访问权限:超级用户、管理员、仅网络说明:配置本地电子邮件服务器的设置.
选项自变量说明-fNMC将从其发送电子邮件的地址.
-s本地SMTP服务器的IPv4/IPv6地址或DNS名称.
-pSMTP端口号,默认为25.
端口选项包括:25、465、587、2525、5000-32768-a如果SMTP服务器需要进行身份验证,则启用此选项.
-u如果SMTP服务器需要身份验证,请在此处键入用户名和密码.
-w-e加密选项:none:SMTP服务器不要求/不支持加密.
ifavail:SMTP服务器发出支持STARTTLS的公告,但不要求加密连接.
always:SMTP服务器要求STARTTLS命令在连接到它时发送.
implicit:SMTP服务器只接受已加密的连接.
无STARTTLS消息发送至服务器.
27UPS网络管理卡2CLI用户指南示例:From:address@example.
comServer:mail.
example.
comPort:25Auth:disabledUser:UserPassword:Encryption:noneReq.
Cert:disabledCertFile:-c需要CA根证书:此选项只应在您组织的安全策略不允许TLS连接的隐式信任时启用.
启用后,必须将有效的根CA证书加载到NMC才能发送加密电子邮件.
-i此字段取决于NMC上安装的根CA证书和是否需要根CA证书.
选项自变量说明28UPS网络管理卡2CLI用户指南snmp访问权限:超级用户、管理员、仅网络说明:启用或禁用并配置SNMPv1.
注意:在v6.
8.
0及更高版本中,SNMPv1默认为禁用状态.
必须设置团体名称(-c[n]),才能建立SNMPv1通信.
在下表中,n表示访问控制编号:1、2、3或4.
示例:若要启用SNMP版本1,键入:snmp-Senablesnmpv3访问权限:超级用户、管理员、仅网络说明:启用或禁用并配置SNMPv3.
注意:在v6.
8.
0及更高版本中,SNMPv3默认为禁用状态.
必须使用密码(-a[n]、-c[n])启用有效的用户配置文件,才能建立SNMPv3通信.
选项自变量说明-Senable|disable启用或禁用SNMPv1.
-c[n]团体指定团体名称或字符串.
-a[n]read|write|writeplus|disable指示使用权限.
-n[n]IP或域名指定网络管理站的IPv4/IPv6地址或域名.
29UPS网络管理卡2CLI用户指南在下表中,n表示访问控制编号:1、2、3或4.
示例:若要为用户"JMurphy"授予访问级别2,键入:snmpv3-au2"JMurphy"snmptrap使用权限:超级用户、管理员、仅网络用户说明:启用或禁用SNMP陷阱生成.
选项自变量说明-Senable|disable启用或禁用SNMPv3.
-u[n]指定用户名、身份验证短语以及加密短语.
-a[n]-c[n]-ap[n]sha|md5|none指示身份验证协议的类型.
-pp[n]aes|des|none指示隐私(加密)协议.
-ac[n]enable|disable启用或禁用访问权限.
-au[n]授予对指定用户配置文件的访问权限.
-n[n]指定网络管理站的IPv4/IPv6地址或主机名.
选项自变量说明-c[n]指定团体名称或字符串.
-r[n]陷阱接收器的IPv4/IPv6地址或主机名.
-l[n][语言代码]指定语言.
必须安装包含所需语言的语言包,语言代码如下:enUS-EnglishdeDe-GermanruRu-RussianzhCn-ChinesejaJa-JapanesekoKo-KoreanitIt-ItalianptBr-PortuguesefrFr-FrenchesEs-Spanish-t[n][snmpV1|snmpV3]指定SNMPv1或SNMPv3.
-g[n][enable|disable]启用或禁用该陷阱接收器的陷阱生成.
默认情况下为启用状态.
30UPS网络管理卡2CLI用户指南示例:要使用默认语言"英语"针对团体名称为public、IP地址为10.
169.
118.
100的接收器1启用和配置SNMPv1陷阱,请输入以下命令:snmptrap-c1public-r110.
169.
118.
100-l1enUS-t1snmpV1-g1enableE000:Successsystem使用权限:超级用户、管理员说明:查看和设置系统名称、联系人、位置,以及查看已运行时间、日期和时间、登录的用户和高层系统状态P、N、A(请参阅"主屏幕状态字段").
示例1:若要将设备位置设置为TestLab,键入:system-l"TestLab"示例2:若要将系统名称设置为DonAdams,键入:system-n"DonAdams"tcpip访问权限:超级用户、管理员、仅网络说明:查看和手动配置NMC的以下IPv4TCP/IP设置:-a[n][enable|disable]启用或禁用该陷阱接收器的陷阱身份验证(仅限SNMPv1).
-u[n](用户名)为该陷阱接收器的用户配置文件选择标识符(仅限SNMPv3).
n=陷阱接收器编号=1、2、3、4、5或6选项自变量说明-n定义设备名称、设备负责人姓名以及设备的物理位置.
注:如果您使用多个词定义一个值,则必须将该值用引号引起来.
这些值也供StruxureWareDataCenterExpert,或EcoStruxureITExpert和NMC的SNMP代理使用.
-c-l-m在WebUI或CLI的登录页上显示自定义消息或横幅.
-senable|disable同步系统和主机名.
这与使用"dns-y"的效果一样.
选项自变量说明-Senable|disable启用或禁用TCP/IPv4.
-i使用xxx.
xxx.
xxx.
xxx格式键入NMC的IP地址.
选项自变量说明31UPS网络管理卡2CLI用户指南示例1:若要查看NMC的网络设置,键入tcpip,并按下ENTER.
示例2:若要为NMC手动配置IP地址150.
250.
6.
10,键入:tcpip-i150.
250.
6.
10tcpip6访问权限:超级用户、管理员、仅网络说明:启用IPv6并查看和手动配置NMC的以下IPv6TCP/IP设置:示例1:若要查看NMC的网络设置,键入tcpip6,并按下ENTER.
示例2:若要手动配置NMC的IPv6地址2001:0:0:0:0:FFD3:0:57ab,键入:tcpip-i2001:0:0:0:0:FFD3:0:57ab-s键入NMC的子网掩码.
-g键入默认网关的IP地址.
请勿使用回送地址(127.
0.
0.
1)作为默认网关.
-d键入DNS服务器配置的DNS名称.
-h键入NMC将使用的主机名.
选项自变量说明-Senable|disable启用或禁用TCP/IPv6.
-manenable|disable启用NMC的IPv6地址的手动寻址.
-autoenable|disable允许NMC自动配置IPv6地址.
-i设置NMC的IPv6地址.
-g设置默认网关的IPv6地址.
-d6router|statefull|stateless|never使用以下参数设置DHCPv6模式:由路由器控制、有状态(对于地址和其他信息,都保持其自身的状态)、无状态(对于除地址以外的信息,不保持其自身的状态)和从不.
选项自变量说明32UPS网络管理卡2CLI用户指南uio使用权限:超级用户、管理员、设备用户说明:该命令可用于连接有干触点I/O(AP9810)的AP9631或AP9635网络管理卡2.
示例1:若要打开输出,键入:uio-rc2open示例2:若要查看连接至通用输入/输出端口2的干触点I/O的设备的状态,键入:uio-st2ups某些ups选项取决于UPS型号.
并非所有配置都支持ups命令的所有选项.
使用权限:超级用户、管理员、设备用户选项自变量说明-rcopen|close更改所连接的输出的状态,并指定UIO(通用输入/输出)端口号.
-st,|–查看与干触点I/O相连的传感器的状态.
若要查看特定传感器或多个传感器的状态,请键入它们的UIO端口号.
-disc|,|–指定新的输入触点或输出继电器连接.
33UPS网络管理卡2CLI用户指南说明:控制UPS和查看状态信息.
有关与该屏幕相关的这些选项的信息,请参阅APC网站上的《用户指南》.
选项自变量说明-creboot通过下列方式,重新启动连接的装置:关闭UPS电源.
UPS电池电量至少恢复为"最低电池电量"中配置的百分比后,打开UPS的电源.
请参阅"cfgshutdn".
on打开UPS的电源.
off立即关闭UPS的输出电源,没有关机延迟.
UPS将保持关闭状态,直到您再次将其打开.
graceoff在"所需的最大延迟"过后,关闭UPS的插座电源.
gracereboot该操作与上文的重新启动类似,但是在关闭前,有额外的延迟.
连接的设备只有在UPS等待"所需的最大延迟"后才会关闭,延迟计算方法在《用户指南》的"关闭延迟和PowerChuteNetworkShutdown"主题中有介绍.
sleep通过在定义的时间内关闭输出电源,使UPS进入休眠模式.
UPS在等待"关闭延迟"中配置的时间过后,将关闭输出电源.
输入电源恢复时,UPS在配置的"休眠时间"过后将打开输出电源.
请参阅"cfgshutdn".
gracesleep使UPS进入休眠模式(在定义的时间内关闭电源):UPS在等待"所需的最大延迟"后,关闭输出电源,以确保PowerChuteNetworkShutdown有时间安全地关闭其服务器,并具有充分的"关闭延迟".
输入电源恢复时,UPS在配置的"休眠时间"过后将打开输出电源.
请参阅"cfgshutdn".
-rstart|stop触发或结束运行时间校准.
校准会重新计算剩余的运行时间,并具有下列要求:由于校准操作会临时消耗UPS电池电量,只有电池电量为100%时,才可以执行校准.
负载必须至少为15%,才能确保正常进行校准.
-sstart触发UPS自检.
-benter|exit控制旁路模式的使用.
该命令取决于不同的型号,可能不适用于您的UPS.
34UPS网络管理卡2CLI用户指南-o#Off|DelayOff|On|DelayOn|Reboot|DelayReboot|Shutdown|DelayShutdown|Cancel控制UPS插座组.
使用#代替插座组数量.
插座组的状态为打开时,该选项接受下列自变量:Off—立即关闭组.
DelayOff—经过关机延迟配置的秒数后,关闭插座组.
Reboot—立即关闭组,然后经过重新启动持续时间和供电延迟配置的秒数后将其重新开启.
DelayReboot—经过关机延迟配置的秒数后关闭插座组,然后在重新启动持续时间和供电延迟配置的秒数过后将其重新开启.
Shutdown—如果UPS使用市电模式,这将重新开始插座组.
如果UPS处于电池模式,这将关闭该组,并在重新开启前等待接通交流市电电源.
DelayShutdown—经过关机延迟配置的秒数后,关闭插座组.
Cancel—取消之前的命令,例如关闭.
插座组的状态为关闭时,该选项接受两个自变量:On—立即开启组.
DelayOn—经过供电延迟配置的秒数后,开启插座组.
供电延迟、关机延迟和重新启动持续时间必须在用户界面配置.
-os#查看所有插座组的状态(打开、关闭或重新启动).
若要查看特定插座组的状态,请指定其编号.
例如,键入ups-os1可查看插座组1的状态.
但是:a)当您在带有主插座组的UPS上使用此选项时:1表示主插座组,2表示开关插座组1,3表示开关插座组2,依次类推.
b)在不带主插座组的UPS上:1表示开关插座组1,依次类推.
-st查看UPS的状态.
-astart测试UPS的有声警报.
选项自变量说明35UPS网络管理卡2CLI用户指南MGEGalaxy特定的UPS设备的ups命令选项:这些命令仅适用于MGEGalaxy300和MGEGalaxy7000UPS.
某些选项可能仅适用于个别UPS型号.
示例1:若要触发运行时间校准,键入:ups-rstart示例2:若要立即关闭Smart-UPSXLM上的插座组2,键入:ups-o2off选项自变量说明-input|all显示UPS选定相的输入测量值.
键入"all"显示UPS所有相的信息.
voltage|current|frequency|all指定ups命令的输入测量值.
示例:ups-input2frequency显示UPS第2相的频率.
-bypass|all显示旁路市电选定相的输入测量值.
键入"all"显示旁路市电的所有相.
voltage|current|frequency|all指定ups命令的输入测量值.
示例:ups-bypass2current显示旁路市电第2相的电流.
-output|all显示UPS选定相的输出测量值.
键入"all"显示UPS所有相的信息.
voltage|current|load|power|percload|pf|frequency|all指定ups命令的输出测量值.
示例:ups-output2percload显示UPS第2相的负载百分比.
-batt显示UPS的电池状态.
-about显示有关UPS的信息.
-alc|w显示所有现有的警报.
指定"c"或"w"将显示内容限制为"重要"(c)或"警告"(w)警报.
36UPS网络管理卡2CLI用户指南upsaboutupsabout命令列出的所有UPS信息并非适用于所有UPS设备.
使用权限:超级用户、管理员、设备用户.
说明:显示有关UPS的信息,包括:型号、SKU、序列号、UPS固件版本、生产日期、表观额定功率、实际额定功率、内部电池SKU和外部电池SKU.
upsfwupdate此命令并非适用于所有UPS设备.
使用权限:超级用户、管理员、设备用户.
说明:启动UPS固件更新:按照CLI中的说明来确定是否需要在更新固件之前关闭UPS的输出.
访问APC网站,阅读ID为FA164737和FA170679的知识库文章,了解有关获取固件更新文件的信息.
使用USB更新(仅限AP9631和AP9635):–USB驱动器必须支持USBv1.
1,并且格式必须为FAT、FAT16或FAT32.
–固件更新文件可保存在USB驱动器的根目录或/upsfw/.
目录下.
–此驱动器必须插入NMC的USB端口.
注:固件更新可能需要几分钟时间.
UPS固件更新完成后,才可将USB驱动器从NMC中移除.
如果在更新完成之前移除USB驱动器,固件更新将无法成功.
37UPS网络管理卡2CLI用户指南示例1:upsfwupdate-info-ver"ID11UPS03.
8"Searchingforversion'UPS03.
8'.
.
.
found.
Version'UPS03.
8'atC:\SMX11UPS_03-8.
encE000:SuccessUpdateFile:C:\SMX11UPS_03-8.
encCompatiblewithUPS:YesUpdateVersion:UPS03.
8示例2:upsfwupdate-statusE000:SuccessStatus:3k/257k(1%)选项自变量说明-install-file|-ver注:该选项并非适用于所有UPS设备.
从插入NMCUSB端口的USB驱动器安装UPS固件更新.
包括USB驱动器上固件更新文件的文件路径.
USB驱动器安装在NMC上,驱动器盘符为C:\.
如果USB驱动器中有多个固件文件,则以下列格式提供固件版本:[UPSID号码][UPS固件版本]注:可使用以下介绍的–info命令找到UPSID号码.
-info-file|-ver从插入NMCUSB端口的USB驱动器中参阅可用固件的相关信息.
包括USB驱动器上固件更新文件的文件路径.
如果USB驱动器中有多个固件文件,则以下列格式提供固件版本:[UPSID号码][UPS固件版本]-list显示插入NMCUSB端口的USB驱动器中可用固件版本列表.
-status检查已启动的固件更新的状态.
-lastresult查看最近尝试进行固件更新的结果.
38UPS网络管理卡2CLI用户指南User使用权限:超级用户、管理员说明:配置每个帐户类型的用户名和密码,并配置不活动的超时时间.
(您无法编辑用户名,您必须将其删除,然后再创建一个新用户).
有关每个帐户类型(超级用户、管理员、设备用户、只读用户和仅网络用户)的权限信息,请参阅APC网站上的《用户指南》.
示例:若要将用户"JMurphy"的注销时间更改为10分钟,键入:user-n"JMurphy"-st10选项自变量说明-n指示用户.
-cp超级用户必须指定当前密码.
注:当远程更改"超级用户"的密码时,才需要-cp选项.
-pw指定用户的这些选项.
注:说明必须用引号括起来.
-pe-d-eenable|disable启用或禁用特定用户帐户的访问权限.
-teenable|disable启用触摸屏访问.
-tp尚不可用.
-trenable|disable启用触摸屏远程身份验证覆盖.
此选项仅适用于特定设备.
如果您启用了此覆盖选项,NMC将允许本地用户使用存储于本地NMC上的密码登录.
-st指定键盘空闲时注销用户前会话等待的持续时间.
-srenable|disable使用串行控制台(CLI)连接绕过RADIUS,也称为串行远程身份验证覆盖-elenable|disable指示事件日志颜色编码.
-lftab|csv指示导出日志文件的格式.
-tsus|metric指示温度单位,华氏度或摄氏度.
-df指定时间格式.
-lg指定用户语言.
键入lang以查看所有可用语言.
-del删除用户.
-l显示当前用户列表.
39UPS网络管理卡2CLI用户指南userdflt使用权限:超级用户、管理员说明:"User"建立默认用户首选项的补充功能.
默认用户设置有两个主要功能:在超级用户或管理员级别帐户创建新用户时,确定要在每个字段中填充的默认值.
将设置应用于系统之前,可以更改这些值.
对于远程用户(系统中未存储的进行远程身份验证的用户帐户,如RADIUS),这些是用于身份验证服务器未提供的设置的值.
例如,如果RADIUS服务器没有为用户提供温度首选项,则将使用此部分中定义的值.
选项自变量定义-e(启用)默认情况下,用户将在创建时启用或禁用.
删除末尾的(启用).
-pe(用户权限)指定用户的权限级别和帐户类型.
-d提供用户说明.
说明必须用引号括起来.
-st分钟提供默认的会话超时.
-bl系统禁用帐户之前用户可进行的错误登录尝试次数.
达到此限制后,将会显示一条消息,通知用户帐户已被锁定.
超级用户或管理员级别帐户需要重新启用此帐户,该用户才能重新登录.
注:超级用户帐户无法锁定,但可在需要时手动禁用.
-el(事件日志颜色编码)启用或禁用事件日志颜色编码.
-lf(导出日志格式)指定日志导出格式:tab或CSV.
-ts(温度单位)指定用户的温度单位.
当用户首选项不可用时,此设置也供系统使用(例如,电子邮件通知).
-df(日期格式)指定用户的首选日期格式.
40UPS网络管理卡2CLI用户指南示例.
若要将默认用户的会话超时设置为60分钟,请输入以下内容:userdflt-st60E000:Successweb访问权限:超级用户、管理员、仅网络说明:启用使用HTTP或HTTPS对用户界面的访问.
注意:在v6.
8.
0及更高版本中,HTTP默认为禁用状态,而HTTPS默认为启用状态.
为了提高安全性,您可以将HTTP和HTTPS的端口设置更改为5000-32768之间任何未使用的端口.
之后,用户必须在浏览器的地址字段使用冒号(:)指定端口号.
例如,对于端口号5000和IP地址152.
214.
12.
114,键入:http://152.
214.
12.
114:5000示例:若要禁用使用HTTPS对用户界面的一切访问,键入:web-Sdisablewhoami使用权限:超级用户、管理员、仅设备用户、只读用户、仅网络用户说明:提供有关当前用户的登录信息示例:apc>whoamiE000:Successapc-lg指定用户的首选语言.
键入lang以查看所有可用语言.
-sp启用/禁用强密码.
-pp所需密码更改间隔.
选项自变量定义-henable|disable启用或禁用使用HTTP对用户界面的访问.
-senable|disable启用或禁用使用HTTPS对用户界面的访问.
启用HTTPS后,数据在传输过程中将被加密,并由使用TLS的数字证书进行验证.
-mp指定Web界面使用的最低协议版本:TLSv1.
1或TLSv1.
2.
-ph指定HTTP用于与NMC通信的TCP/IP端口(默认为80).
其他范围为5000–32768.
-ps指定HTTPS用于与NMC通信的TCP/IP端口(默认为443).
其他范围为5000–32768.
-lspenable|disable启用或禁用对WebUI中"受限状态"页面的访问.
-lsdenable|disable在Web浏览器中访问设备的IP或主机名时,启用或禁用"受限状态"页面作为默认页面.
选项自变量定义41UPS网络管理卡2CLI用户指南xferINI使用权限:超级用户、管理员.
该命令仅通过串行/本地控制台CLI可用.
说明:您通过串行连接访问命令行界面时,使用XMODEM上传.
ini文件.
上传完成后:如果系统或网络有任何更改,命令行界面将重新启动,并且您必须再次登录.

如果您选择的文件传输波特率与NMC的默认波特率不同,您必须将波特率重置为默认值,才能与NMC重新建立通信.
xferStatus使用权限:超级用户、管理员说明:查看最近文件传输的结果.
示例:xferStatusE000:SuccessResultoflastfiletransfer:OK有关传输结果代码的说明,请参阅APC网站上的《用户指南》.
cryptlibcopyrightDigitalDataSecurityNewZealandLtd1998.
版权所有1990,1993,1994TheRegentsoftheUniversityofCalifornia.
保留所有权利.
此代码源自MikeOlson为Berkeley编写的软件.
如果满足下列条件,则不论是否已修改,都允许以源代码和二进制形式再分发和使用:1.
源代码的再分发必须保留以上版权声明、此条件列表和以下免责声明.

2.
以二进制形式再分发必须在分发时提供的文档和/或其他材料中复制以上版权声明、此条件列表和以下免责声明.
3.
所有提及本软件功能或软件使用的广告材料中必须显示以下声明:本产品包含由加州大学伯克利分校(UniversityofCalifornia,Berkeley)及其贡献者开发的软件.
4.
未经事先书面许可,在本软件基础上开发的产品不得擅用大学名称或其贡献者名称作宣传或促销.

本软件由董事会和贡献者"按原样"提供,没有任何明示和暗示的担保,包括但不限于对适销性和针对特定用途的适用性的暗示担保.
在任何情况下,董事会或贡献者对由于使用本软件而造成的任何直接、间接、偶然、特殊、惩罚性或后果性的损失(包括但不限于获得替代商品或服务、无法使用、数据丢失、利润损失或业务中断)不承担任何责任,无论由于什么原因、根据何种责任理由;也无论是否属于合同、严格责任或民事侵权范畴(因疏忽或其他原因),即使事先已被告知可能会造成这种损失,概不例外.
APC全球客户支持您可以通过以下任意方式免费获得本产品或其他任何产品的客户支持服务:访问APC网站,以查阅APC知识库中的文档,以及提交客户支持请求.
–www.
apc.
com(公司总部)连接到特定国家或地区的本地化APC网站,每个站点均会提供客户支持信息.
–www.
apc.
com/support/通过搜索APC知识库和使用e-support获取全球支持.
通过电话或电子邮件联系APC客户支持中心.
–国家/地区专属的当地支持中心:有关联系信息,请访问www.
apc.
com/support/contact.
有关如何获取当地客户支持的信息,请与客户支持代表或其他向您出售产品的经销商联系.