位置指定パラメータについて
ONTAP CLI の位置指定パラメータ機能を活用して、効率的にコマンドを入力することができます。あるコマンドの位置指定パラメータは、そのコマンドのヘルプで特定できます。
位置指定パラメータとは何ですか
-
位置指定パラメータは、値を指定する前にパラメータ名を指定する必要のないパラメータです。
-
位置指定パラメータは、コマンド入力に位置指定パラメータとそれ以外のパラメータを組み合わせて指定できます。ただし、コマンド内の他の位置指定パラメータとの相対的な順序(の出力)に従っている必要があり `command_name ?`ます。
-
位置指定パラメータは、必須パラメータの場合とオプションパラメータの場合があります。
-
あるパラメータが 1 つのコマンドでは位置指定パラメータで、別のコマンドでは位置指定パラメータでない場合もあります。
位置指定パラメータ機能をスクリプトで使用することは、特に位置指定パラメータがオプションパラメータである場合や、位置指定パラメータの前にオプションパラメータを指定する場合には推奨されません。 |
位置指定パラメータを特定する
位置指定パラメータは、コマンドの出力で特定できます command_name ?
。位置指定パラメータは、次のいずれかの形式で、パラメータ名が角かっこで囲まれています。
-
[
-parameter_name
] `parameter_value`に、必須の位置指定パラメータを示します。 -
[]][
-parameter_name
`parameter_value`に、オプションの位置指定パラメータを示します。
たとえば、次の出力では command_name ?
、パラメータは該当するコマンドの位置指定パラメータです。
-
[-lif] <lif-name>
-
[[-lif] <lif-name>]
ただし、次の出力では、パラメータは該当するコマンドの位置指定パラメータではありません。
-
-lif <lif-name>
-
[-lif <lif-name>]
位置指定パラメータの使用例
次の出力例では volume create ?
、コマンドの3つのパラメータ(、、) -aggregate`が位置指定パラメータであることが示されています `-volume
-size
。
cluster1::> volume create ? -vserver <vserver name> Vserver Name [-volume] <volume name> Volume Name [-aggregate] <aggregate name> Aggregate Name [[-size] {<integer>[KB|MB|GB|TB|PB]}] Volume Size [ -state {online|restricted|offline|force-online|force-offline|mixed} ] Volume State (default: online) [ -type {RW|DP|DC} ] Volume Type (default: RW) [ -policy <text> ] Export Policy [ -user <user name> ] User ID ... [ -space-guarantee|-s {none|volume} ] Space Guarantee Style (default: volume) [ -percent-snapshot-space <percent> ] Space Reserved for Snapshot Copies ...
次の例では volume create
、位置指定パラメータ機能を使用せずにコマンドを指定しています。
cluster1::> volume create -vserver svm1 -volume vol1 -aggregate aggr1 -size 1g -percent-snapshot-space 0
次の例では、位置指定パラメータ機能を使用して効率的にコマンドを入力しています。位置指定パラメータとそれ以外のパラメータの両方を使用してコマンドを実行 volume create`し、位置指定パラメータの値はパラメータ名なしで指定されます。位置指定パラメータは、の出力と同じ順序で指定されます `volume create ?
。つまり、の値はの値の前に指定され -aggregate
、の値 `-volume`の前に指定され `-size`ます。
cluster1::> volume create vol2 aggr1 1g -vserver svm1 -percent-snapshot-space 0
cluster1::> volume create -vserver svm1 vol3 -snapshot-policy default aggr1 -nvfail off 1g -space-guarantee none