跳到主要内容

命令行参数

适用于运行 symbol 客户端类型的所有控制器的命令行参数​

参数定义
-R（大写字母）定义密码的用户角色。角色可以是：
  • admin – 该用户具有更改存储阵列配置的权限。
  • monitor – 该用户具有查看存储阵列配置的权限，但无法进行更改。

-R 参数只有在与 -p 参数一起使用时才有效，后者用于指定为存储阵列定义了密码。

只有当在存储阵列上启用了双密码功能时才需要 -R 参数。在以下这些情况下不需要 -R 参数：

  • 未在存储阵列上启用双密码功能。

  • 只设置了一个管理员角色，并且没有为存储阵列设置监视者角色。

适用于所有控制器和所有客户端类型的命令行参数​

参数定义
host-name-or-IP-address 指定带内受管存储阵列或带外受管存储阵列的主机名或 Internet 协议（IP）地址（ xxx.xxx.xxx.xxx）。

  • 如果正在通过带内存储管理使用主机来管理存储阵列，则必须使用

    -n 参数或 -w 参数（如果有多个存储阵列连接到主机）。

  • 如果在每个控制器上通过以太网连接使用带外存储管理来管理存储阵列，那么必须指定

    控制器的 host-name-or-IP-address。
-A 将存储阵列添加到配置文件。如果 -A 参数后没有跟随 host-name-or-IP-address，自动发现会扫描本地子网中的存储阵列。
-c 指示输入要在指定存储阵列上运行的一个或多个脚本命令。每条命令以分号结束（ ;）。不能在同一命令行上放置多个 -c 参数。可以在 -c 参数后包含多个脚本命令。
-d 显示脚本配置文件的内容。文件内容的格式如下： storage-system-name host-name1 host-name2
-e 无需首先执行语法检查即可运行命令。
-F（大写字母）指定用于发送所有警报的电子邮件地址。
-f（小写字母）指定一个包含要在指定存储阵列上运行的脚本命令的文件名。 -f 参数与 -c 参数的相似之处在于，这两个参数都用于运行脚本命令。 -c 参数运行独立脚本命令。而 -f 参数运行脚本命令文件。

缺省情况下，会忽略运行文件中的脚本命令时遇到的任何错误，然后继续运行该文件。要覆盖此行为，请使用脚本文件中的 set session errorAction=stop 命令。

-g 指定一个包含所有电子邮件警报通知中将加入的电子邮件发件人联系信息的 ASCII 文件。CLI 假设 ASCII 文件为纯文本文件，没有分隔符或需要的格式。如果存在 userdata.txt 文件，请勿使用 -g 参数。
-h 指定运行存储阵列所连接的 SNMP 代理的主机名。将 -h 参数与以下参数一起使用：
  • -a
  • -x
-I（大写字母）指定电子邮件警报通知中要加入的信息的类型。您可以选择以下值：
  • eventOnly – 仅在电子邮件中包含事件信息。
  • profile – 电子邮件中包含事件和阵列概要文件信息。

可以使用 -q 参数指定发送电子邮件的频率。

-i（小写字母）显示已知存储阵列的 IP 地址。将 -i 参数与 -d 参数一起使用。文件内容的格式如下：

storage-system-name IP-address1 IPaddress2

-n 指定要在其上运行脚本命令的存储阵列的名称。在使用 host-name-or-IP-address 时此名称是可选的。如果使用带内方法来管理存储阵列，并且有多个存储阵列连接到指定地址的主机，则必须使用 -n 参数。未使用 host-name-or-IP-address 时，需要提供存储阵列名称。
-o 为运行脚本命令所产生的所有输出文本指定一个文件名。将 -o 参数与以下参数一起使用：
  • -c
  • -f

如果未指定输出文件，输出文本会采用标准输出（stdout）。无论是否设置此参数，非脚本命令的命令产生的所有输出都将发送给 stdout。

-p 为要在其上运行命令的存储阵列定义密码。在以下这些情况下不需要密码：

  • 存储阵列上未设置密码。

  • 正在运行的脚本文件中指定了密码。

  • 通过使用

    -c参数和此命令指定密码：

    set session password=
    <var id="GUID-0A2BD9BE-3681-4F2D-B51B-9562CB03DF84__V881675" className="keyword varname">
        password
    </var>

-P

该参数需要以下两个参数之一：

  • password_file — 包含用于身份验证的密码。
  • -（短横线）- 从 stdin 读取密码。

请注意，增加的此参数适用于所有控制器，无论是使用 https 客户端型还是 symbol 客户端类型。

-q 指定要接收事件通知的频率和事件通知中返回的信息类型。始终为每个紧急事件生成至少包含基本事件信息的电子邮件警报通知。

-q 参数具有以下有效值：

  • everyEvent – 通过每个电子邮件警报通知返回信息。
  • 2 - 以不超过 2 小时一次的频率返回信息。
  • 4 - 以不超过 4 小时一次的频率返回信息。
  • 8 - 以不超过 8 小时一次的频率返回信息。
  • 12 - 以不超过 12 小时一次的频率返回信息。
  • 24 - 以不超过 24 小时一次的频率返回信息。

使用 -I 参数，可以指定电子邮件警报通知中的信息类型。

  • 如果将

    -I 参数设置为 eventOnly ，则 -q 参数的唯一有效值为 everyEvent 。

  • 如果将

    -I 参数设置为 profile 值或 supportBundle 值，则电子邮件中包含此信息，频率由 -q 参数指定。
-quick 减少运行单行操作所需的时间长度。 recreate snapshot volume 命令是一个单行操作示例。此参数不运行后台进程，因此可减少命令的运行时间。

请勿在执行涉及多个单行操作的操作时使用此参数。广泛使用此命令可导致控制器超出其处理能力运行多个命令，从而导致操作故障。此外，通常从后台进程收集到的状态更新和配置更新将不可用于 CLI。此参数会导致依靠背景信息的操作发生故障。

-S（大写字母）运行脚本命令时，禁止出现描述命令进度的参考消息。（禁止参考消息也称为静默模式。）该参数禁止显示以下消息：
  • Performing syntax check
  • Syntax check complete
  • Executing script
  • Script execution complete
  • SMcli completed successfully
-v 当与 -d 参数一起使用时，会在配置文件中显示已知设备的当前全局状态。
-w 指定存储阵列的 WWID。此参数是 -n 参数的备用参数。将 -w 参数与 -d 参数一起使用，可显示已知存储阵列的 WWID。文件内容的格式如下：

storage-system-name world-wide-ID IP-address1 IP-address2

-X（大写字母）从配置中删除存储阵列。
-? 显示关于 CLI 命令的使用信息。