Go to main content

Oracle® ZFS Storage Appliance 管理ガイド、Release OS8.8.x

印刷ビューの終了

更新: 2021 年 8 月
 
 

CLI のプロパティー

プロパティーとは、コンテキストに関連付けられている、型付けされた名前と値のペアです。特定のコンテキストのプロパティーは、「help properties」コマンドを実行することによって確認できます。ユーザーの設定に関連付けられたプロパティーを取得する例を次に示します。

hostname: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 コマンドを使用してユーザーのプリファレンスを取得する例を次に示します。

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

get コマンドは、引数として指定された任意のプロパティーを返します。たとえば、login_screen プロパティーの値を取得するには:

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

get コマンドは、使用可能なプロパティーの名前によってタブ補完されます。たとえば、iSCSI サービスの使用可能なプロパティーのリストを表示するには:

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

select コマンド、または二重引用符で囲んだコマンドは、プロパティー別の動的ノードを選択します。たとえば、ユーザー別に key-000 を選択するには:

hostname:configuration services sftp keys> show
Keys:

NAME    MODIFIED            CIPHER   USER    COMMENT
key-000 2019-6-5 19:48:23   RSA      u1      1

hostname:configuration services sftp keys> "user=u1"
hostname:configuration services sftp key-000>

set コマンドは、プロパティーを指定された値に設定します。ここで、プロパティー名とその値は等号で区切られます。たとえば、login_screen プロパティーを「shares」に設定するには:

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

アプライアンス上の状態を構成するプロパティーの場合は、プロパティーを設定してもその値は変更されず、代わりに、設定された値が記録され、そのプロパティーの値はコミットされていないことが示されます。

設定済みのプロパティー値を強制的に有効にするには、それらのプロパティー値を明示的にコミットして、複数の値を 1 つの整合性のある変更として変更できるようにする必要があります。いずれかのコミットされていないプロパティー値をコミットするには、commit コマンドを使用します。

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

コミットされていないプロパティーを含むコンテキストから移動しようとすると、この移動によって設定済みのプロパティー値が破棄される旨の警告が表示され、移動を確認するよう求められます。例:

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

コンテキスト内のプロパティーが別のコンテキストから設定された場合、つまり、コンテキストを変更するコマンドに set コマンドが追加された場合、そのコミットは暗黙的に行われ、制御が発信元のコンテキストに返される前に実行されます。例:

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

一部のプロパティーには、値のリストを指定します。これらのプロパティーでは、リストの要素をコンマで区切るようにしてください。たとえば、NTP の servers プロパティーを、次のように NTP サーバーのリストに設定できます。

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

プロパティー値にコンマ、等号、引用符、または空白が含まれている場合は、値全体を二重引用符で囲む必要があります。たとえば、デフォルトのプロジェクトの sharenfs シェアプロパティーを読み取り専用にし、ホスト kiowa に読み取り/書き込みアクセスを提供するよう設定するには、次のようにします。詳細は、シェアとプロジェクトを参照してください。

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

一部のプロパティーは変更不可能です。その値は取得できますが、設定することはできません。変更不可能なプロパティーを設定しようとすると、エラーが生成されます。たとえば、デフォルトのプロジェクトの変更不可能な space_available プロパティーを設定しようとすると、次のようになります。詳細は、シェアとプロジェクトを参照してください。

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

ほかの一部のプロパティーは、特定の条件でのみ変更不可能です。これらのプロパティーに対して、set コマンドは有効ではありません。たとえば、bmc という名前のユーザーがネットワークユーザーである場合、fullname プロパティーは変更不可能です。

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

関連トピック