test

Sun Management Center 3.5 用户指南

CLI 参数

大多数 CLI 参数是“名称-值”对：每个参数都包含一个名称和一个值。只有少数参数只有名称而没有值。这些参数称为标记。

参数范围

可以在 CLI 会话中的多个位置指定参数值：

参数语法

参数被指定为名称=值对：

file=/home/examples/example1

其中参数名称为 file，参数值为 /home/examples/example1。等号 (=) 与参数名和参数值之间不能有空格。如果值中包含空格或制表符，则必须以双引号字符（ASCII 字符 0x22）将该值括起：

moduleDesc="Local File Scanning"

参数值可以是由逗号分隔的多个值，值之间不能有空格，如下所示。

severity=DIS,DWN,ERR

参数列表是以空格分隔的参数序列，如下所示。

m=kernel-reader moduleDesc="My Kernel Reader"

可接受和不可接受的参数语法示例

以下参数中的语法是可接受的：

ok1="This is just a test"
ok2=hello
ok3=hello,hi,aloha
ok4="hello,hi,aloha"

以下参数中的语法是不可接受的：

broken1="How are you?","Who are you?"
broken2="Testing",1,2,3
broken3="Hello
broken4=Hello"

参数输入文件格式

可将参数存储在文件中，并在需要时进行读取。可以根据需要创建任意数目的参数文件。可以使用内置的 i 参数指定所需参数输入文件的名称。

预定义的参数和标记

本节介绍在 CLI 中具有预定义含义的参数，

注意：

其中部分预定义参数的名称为单个字母。例如 a、f 和 o。这些都是正确的参数名，并没有错误。

- b

如果启动 CLI 时在 UNIX 命令行中包含此标记，则指示 CLI 在批处理模式下运行。在会话模式下将忽略此标记。

- h

如果在会话模式下使用此标记作为命令的参数，则指示 CLI 显示命令的帮助文本。

- l

此标记的名称为小写字母 l（ASCII 字符 0x6c），而不是数字 1（ASCII 字符 0x31）。 如果在会话模式下将此标记用作扩展命令的参数，则指示 CLI 在执行当前命令时保持最后一条扩展命令中的参数值不变。如果指定了 -l 标记，则为当前命令指定的任何其它参数都将被忽略。此标记对基本命令没有影响。以下示例说明了 -l 标记的用法：


> getLoadModules a=myHostName
...
...
> getAlarms -l

getAlarms 命令在执行时将使用此前执行的 getLoadModules 命令中的参数 a (myHostName ) 的值。

a

参数 a 的值表示代理，它被指定为代理主机和（可选）端口号。如果指定了端口号，请使用冒号 (:)。 一般语法为 a=agentHost[:agentPort]。例如，要指定在主机 example_host 上运行并监听端口 12345 的代理，应使用以下语法：


a=example_host:12345

参数 a 的值也可以是用逗号分隔的代理名称列表：a=agent[, agent]+.

append

参数 append 的值是一个文件的名称，命令输出将附加到其中。如果此文件不存在，将创建它。如果全局设置 append 参数，则该会话中所有命令的输出都将附加到指定的文件中。也可以为特定命令设置此参数，如下所示。


append=/home/examples/cli_output

如果同时设置了 append 参数和 o 参数，则 append 将优先于 o。只在指定文件中记录命令结果，并不记录实际的命令。可以使用 log 参数记录命令信息。

columns

参数 columns 的值是由 print 命令显示的一列或多列命令输出的名称。列名称区分大小写。多个列名称之间用逗号分隔。下例使用了几个列名称。


columns="Alarm Id,Node URL,Target Host,Severity"
f

f 参数的值确定命令输出的格式。当前格式为 plain 和 html。详细信息，请参见命令输出格式。要将格式设置为 HTML，可使用以下语法：


f=html
height

height 参数的值是在屏幕上显示的命令输出的行数。下例将 height 设置为大约相当于标准终端屏幕的高度：


height=24
i

i 参数的值是输入文件的名称，该文件中包含的参数定义要包含在当前会话中。输入文件中的每个参数定义应位于不同的行上。例如，假设 /home/examples/myParams 文件中包含以下各行：


more=off
serverHost=myserver
a=myagent:161

可在下面的行中将这些参数包含到当前的 CLI 会话中：


i=/home/examples/myParams
log

log 参数的值是一个文件的名称，此文件记录了所有 CLI 命令和执行命令的时间。注意，日志文件只记录命令名称和命令执行的时间。命令输出记录在由参数 a 或参数 o 指定的文件中。设置该参数后，所有后续命令都附加到该文件中。如果此文件不存在，将创建它。由于打开日志记录时不覆盖日志文件，因此在需要创建其它日志时要确保另外指定一个文件。要关闭日志记录，可对 log 参数使用 unset 命令。下例将启动日志，然后再停止日志。


> log=/home/examples/sunmc-log
...
...
> unset log
m

m 参数的值是 Sun Management Center 模块的名称。该值也可以是由逗号分隔的模块列表。


m=kernel-reader
more

more 参数的值控制屏幕上显示的命令输出的分页。可以使用的值包括 on 和 off。如果将 more 设置为 on，则到终端的所有后续输出一次显示一屏。屏幕大小由 height 和 width 参数定义。在批处理模式下，缺省值为 off；在会话模式下，缺省值为 on。


more=on
o

o 参数的值是向其中写入命令输出的文件的名称。如果此文件已存在，则将其覆盖。通过将 o 参数指定给特定命令，可以使用 o 参数捕获该命令的输出。也可以使用 set 命令全局设置该参数，将所有后续输出写入到某个文件。

如果同时设置了 append 参数和 o 参数，则 append 将优先于 o。命令输出将附加到指定的文件。只在该文件中写入命令输出，并不记录实际的命令。可以使用 log 参数记录命令信息。下例定义了将命令输出写入其中的文件。


o=/home/examples/sunmc-output
serverHost

serverHost 参数的值确定登录时 CLI 连接的服务器主机。CLI 连接到服务器后，将无法更改此全局参数。

serverPort

serverPort 参数的值表示登录的服务器端口。建立登录会话后，将无法设置此全局参数。如果未设置此参数，将使用缺省端口 2099。

t

t 参数的值表示在拓扑代理中管理的对象的名称。该对象可以是域、视图组或实体。对象名称是以域名开头的全限定名称，例如 /domain/group/host。