Sun Management Center 3.6.1 用户指南

基本 CLI 命令

以下列表介绍了基本的 CLI 命令。

alias

说明

使用 alias 命令可以为经常使用的命令或包含复杂参数的命令创建别名。别名不能与现有 CLI 命令的名称相同。别名定义中的空格必须用双引号(",ASCII 字符 0x22)括起。

当用户退出 CLI 会话时,用户指定的别名将保存在 aliases 目录下的一个文件内。当用户登录到 CLI 会话中时,便可以使用这些别名。

语法

alias [<pseudonym>="command [parameters]"]

示例


> alias assign=set
> alias alarms="getAlarms severity=dwn"

如果调用时没有带任何参数,alias 命令将打印一份已定义的别名列表以及这些别名对应的值。下例显示了调用时不包含参数的 alias 命令的结果。


> alias
assign - set
alarms - getAlarms severity=dwn
attrib

说明

attrib 命令用来检索拓扑对象的属性。

语法

attrib [group=groupName [name=attribName] [-key]]

browse

说明

browse 命令用于激活拓扑的浏览模式。

语法

browse

cd

说明

cd 命令用于更改当前的拓扑路径。如果没有指定任何路径,则把默认的域设置为当前路径。如果指定了一个数值 (n),则当前路径将被设置为第 n 级子路径,如 list 命令所示。

语法

cd [path|number]

clear

说明

clear 命令用于删除当前会话期间设置的所有参数。但是,此命令不会删除从命令行设置的参数。此命令与 unset 命令作用相似,但是不要求参数名是变量。

语法

clear

data

说明

data 命令用于显示拓扑对象的详细信息。如果指定了一个数值 (n),则路径将被设置为第 n 级子路径,如 list 命令所示。

语法

data [path|number|-key]

end

说明

end 命令用于取消激活拓扑的浏览模式。

语法

end

exit

说明

exit 命令用于终止您的服务器连接和 CLI 会话。

语法

exit [-onError]

参数

onError

如果在执行上一条命令的过程中发生了异常,onError 参数可用于终止该 CLI 会话。该参数仅可用于批处理模式下。


注 –

exit 命令和 quit 命令具有完全相同的功能。


goto

说明

goto 命令用于导航到符合大小写模式的拓扑路径。如果发现多条匹配的路径,将提示用户选择其中一条路径。

语法

goto <pattern>

help

说明

help 命令用于显示有关 CLI 命令及其参数的信息。帮助信息适于显示在非位图模式的终端屏幕上。执行 help 命令而不包含参数时,该命令将按字母顺序显示可用 CLI 命令的列表及其简要说明。首先列出基本命令,然后是扩展命令。

语法

help [-e][-h] [<command>|about|legal]

参数

-e-hcommandaboutlegal

-e 以详细模式显示帮助文本。也支持使用以下格式:<command> -e

-h 以正常模式显示帮助文本。也支持使用以下格式:<command> -h

command 显示特定于该命令的信息。

about 显示 CLI 的版本信息。

legal 显示 CLI 的许可证条款。

示例

下例显示了 getAlarms 命令的帮助。


> help getAlarms
getAlarms [a=host[,host]+] [alarm_filter_list]
 - Get alarm information on an agent or a list of agents under a
set of filter conditions. If no agent is provided, all alarms will
be obtained. All the filter conditions are "ANDED" to provide the
result. The filter conditions as specified in alarm_filter_list
comprises:
  domain=domain and/or
  m=module[+instance] and/or
  managed_object=managed_object and/or
  property=property and/or
  property_instance=property_instance and/or
  qualifier=qualifier and/or
  severity=[DIS,DWN,ERR,OFF,INF,IRR,WRN] and/or
  state=[C,F,O] and/or
  ack=[A,N]
history

说明

history 命令用于列出或执行以前输入到 CLI 会话中的命令。如果调用 history 命令时没有带任何参数,并且之前设置了历史记录,则会列出以前输入的所有命令。 如果调用 history 命令时带有一个数字参数,并且之前设置了历史记录,则会执行符合该参数的命令。

语法

history [num]

kill

说明

kill 命令用于终止正在后台运行的所有命令。

语法

kill

list

说明

list 命令用于列出某条路径下的对象。如果指定了一个数值 (n),则路径将被设置为第 n 级子路径,如该命令所示。

语法

list [path|number]

locate

说明

locate 命令用于查找所有符合指定模式的拓扑路径。该模式区分大小写。

语法

locate <pattern>

login

说明

login 命令用于建立与 Sun Management Center 服务器的连接。您可以将 serverHost 参数和 serverPort(可选)参数指定为变量。如果未指定主机,系统会提示用户指定一台主机。如果没有指定任何端口,将使用 2099。login 命令还会提示您输入用户名和密码。

语法

login [serverHost=host] [serverPort=portNumber] [user=userName] [password=userPassword]

参数

serverHostserverPortuserpassword

logout

说明

logout 命令用于终止您与 Sun Management Center 服务器的连接,但不会终止 CLI 会话。

语法

logout

print

说明

print 命令将上一个扩展命令的输出以指定的格式定向到指定的目标。缺省情况下,print 命令将此输出以纯文本格式定向到终端屏幕。如果设置了参数 appendo,则输出将被定向到由这两个参数指定的文件中,而不会显示在屏幕上。如果没有指定 ncols 参数,则将默认的列数设置为 4。


注 –

print 命令不会保存在命令历史记录中。


语法

print [f=plain|xml|html] [style=table|list|<custom>] [columns= columnList] [ncols=num] [o=outputFile | append=appendFile]

参数

fstylecolumns ncolsoappend

quit

说明

quit 命令用于断开与服务器的连接,并终止 CLI 会话。


注 –

quit 命令和 exit 命令之间没有差别。


语法

quit

reset

说明

reset 命令用于将命令行中指定的所有参数的值恢复为 CLI 会话开始时指定的值。会话过程中(而非命令行中)定义的参数将保持不变。如果提供了特定的参数名称作为 reset 命令的变量且已在命令行指定了该参数,则该参数的值将恢复为初始值。否则,该参数的值将保持不变。


注 –

reset 命令不会保存在命令历史记录中。


语法

reset [<parameter>]*

set

说明

set 命令用于指定参数值或显示参数值。参数值由 set 命令指定的参数在当前会话中是全局参数。在该会话期间,全局命令适用于所有命令。如果执行 set 命令时没有带任何变量,则会显示当前会话期间定义的所有参数的值。如果使用一个已指定为变量的参数执行 set 命令,则将显示该参数的值。

语法

set [<parameter>[=value]]* [height=num] [history=num] [log=file] [logmode=detailed|command|"from n"] [more=on|off] [prompt=prompt]

示例

下例显示了此命令的所有三种情况。


> set height=10
> set
height=10
> set height
height=10
status

说明

status 命令用于显示正在后台运行的所有命令的状态。

语法

status

unalias

说明

unalias 命令用于删除作为变量指定的一个或多个别名。

语法

unalias [<pseudonym>]*

unset

说明

unset 命令用于从当前的会话中删除指定的参数(一个或多个)。

语法

unset [<parameter>]*


注 –

unset 命令不保存到命令历史记录中。


where

说明

where 命令用于显示当前的拓扑路径。

语法

where