Oracle® ZFS Storage Appliance 管理指南,发行版 2013.1.5.0

退出打印视图

更新时间: 2016 年 2 月
 
 

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" 提供读取/写入访问权限,请运行以下命令。有关更多信息,请参见Working with Shares

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

有些属性是不可变的;您可以获取它们的值,但是无法设置它们的值。尝试设置不可变属性会导致错误的发生。例如,尝试设置默认项目的不可变 space_available 属性。有关更多信息,请参见Working with Shares

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"

相关主题