CLI 属性

属性是与上下文关联的类型化名称/值对。给定上下文的属性可以通过运行 "help properties" 命令确定。下面的示例检索与用户首选项关联的属性：

dory:configuration preferences> help properties
Properties that are valid in this context:

  locale               => Locality

  login_screen         => Initial login screen

  session_timeout      => Session timeout

  session_annotation   => Current session annotation

  advanced_analytics   => Make available advanced analytics statistics

给定上下文的属性可以使用 get 命令检索。下面的示例使用 get 命令检索用户的首选项：

 dory:configuration preferences> get 
                       locale = C
                 login_screen = status/dashboard
              session_timeout = 15
           session_annotation = 
           advanced_analytics = false

get 命令将返回作为参数提供给它的任何属性。例如，要获取 login_screen 属性的值，请运行以下命令：

dory:configuration preferences> get login_screen
                 login_screen = status/dashboard

get 命令将对可用属性的名称使用 Tab 补齐功能。例如，要查看 iSCSI 服务的可用属性列表，请运行以下命令：

dory:> configuration services iscsi get tab 
<status>            isns_server         radius_secret       target_chap_name
isns_access         radius_access       radius_server       target_chap_secret

set 命令使用通过等号分隔的属性名称及其值将属性设置为指定的值。例如，要将 login_screen 属性设置为 "shares"，请运行以下命令：

dory:configuration preferences> set login_screen=shares
                 login_screen = shares (uncommitted)

请注意，对于构成设备状态的属性，设置属性不会更改其值，而是记录设置的值并指示该属性的值未提交。

要强制设置的属性值生效，必须显式提交这些值，以允许一次连续更改多个值。要提交任何未提交的属性值，请使用 commit 命令：

dory:configuration preferences> get login_screen 
                 login_screen = shares (uncommitted)
dory:configuration preferences> commit
dory:configuration preferences> get login_screen
                 login_screen = shares

如果尝试离开包含未提交属性的上下文，则系统会警告您离开将放弃设置的属性值，并提示您确认自己将离开。例如：

dory:configuration preferences> set login_screen=maintenance/hardware
                 login_screen = maintenance/hardware (uncommitted)
dory:configuration preferences> done
You have uncommitted changes that will be discarded. Are you sure? (Y/N) 

如果在某一个上下文中设置另一个上下文中的属性（即，如果将 set 命令附加到更改上下文的命令），则提交为隐式提交，并且提交在控制权返回给发起操作的上下文之前执行。例如：

dory:> configuration preferences set login_screen=analytics/worksheets
                 login_screen = analytics/worksheets
dory:>

有些属性采用值列表。对于这些属性，应使用逗号分隔列表元素。例如，NTP servers 属性可以设置为一个 NTP 服务器列表：

dory:configuration services ntp> set servers=0.pool.ntp.org,1.pool.ntp.org
                      servers = 0.pool.ntp.org,1.pool.ntp.org (uncommitted)
dory:configuration services ntp> commit

如果某个属性值包含逗号、等号、引号或空格，则整个值必须使用引号括起来。例如，要将默认项目的 sharenfs 共享资源属性设置为只读属性，但是向主机 "kiowa" 提供读取/写入访问权限，请运行以下命令。有关更多信息，请参见使用共享资源。

dory:> shares select default
dory:shares default> set sharenfs="ro,rw=kiowa"
                     sharenfs = ro,rw=kiowa (uncommitted)
dory:shares default> commit

有些属性是不可变的；您可以获取它们的值，但是无法设置它们的值。尝试设置不可变属性会导致错误的发生。例如，尝试设置默认项目的不可变 space_available 属性。有关更多信息，请参见使用共享资源。

dory:> shares select default
dory:shares default> get space_available 
              space_available = 1.15T
dory:shares default> set space_available=100P
error: cannot set immutable property "space_available"

一些其他属性仅在特定的情况下才不可变。对于这些属性，set 命令无效。例如，如果名为 bmc 的用户是一个网络用户，则 fullname 属性将不可变：

dory:> configuration users select bmc set fullname="Rembrandt Q. Einstein"
error: cannot set immutable property "fullname"

另请参见：

• 浏览器用户界面 (Browser User Interface, BUI)

• 命令行界面 (Command Line Interface, CLI)