プロパティーとは、コンテキストに関連付けられている、型付けされた名前と値のペアです。特定のコンテキストのプロパティーは、「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 コマンドは、使用可能なプロパティーの名前によってタブ補完されます。たとえば、iSCSI サービスの使用可能なプロパティーのリストを表示するには、次のコマンドを実行します。
dory:> 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 2015-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」に設定するには、次のコマンドを実行します。
dory:configuration preferences> set login_screen=shares
login_screen = shares (uncommitted)
アプライアンス上の状態を構成するプロパティーの場合は、プロパティーを設定してもその値は変更されず、代わりに、設定された値が記録され、そのプロパティーの値はコミットされていないことが示されます。
設定済みのプロパティー値を強制的に有効にするには、それらのプロパティー値を明示的にコミットして、複数の値を 1 つの整合性のある変更として変更できるようにする必要があります。いずれかのコミットされていないプロパティー値をコミットするには、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"
関連トピック