Skip to main content
日本語は機械翻訳による参考訳です。内容に矛盾や不一致があった場合には、英語の内容が優先されます。

コマンド入力でONTAP CLIの位置パラメータを使用する

共同作成者 netapp-sumathi netapp-aherbin netapp-barbe
PDF

ONTAP CLIの位置パラメータ機能を利用すると、コマンド入力の効率を高めることができます。コマンドをクエリすることで、そのコマンドの位置パラメータを特定できます。

位置パラメータとは

  • 位置パラメータは、パラメータ値を指定する前にパラメータ名を指定する必要がないパラメータです。

  • 位置パラメータは、 `command_name ?`出力に示されているように、同じコマンド内の他の位置パラメータとの相対的な順序を守っている限り、コマンド入力内で非位置パラメータと混在させることができます。

  • 位置パラメータは、コマンドの必須パラメータまたはオプションパラメータになります。

  • パラメータは、あるコマンドでは位置指定可能だが、別のコマンドでは位置指定不可になる場合があります。

メモ

位置パラメータ機能をスクリプトで使用することは、特に位置パラメータがコマンドに対してオプションである場合や、位置パラメータの前にオプションのパラメータがリストされている場合には推奨されません。

位置指定パラメータの特定

`*_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 ?`出力に、コマンドに対して `-volume、 -aggregate、 `-size`の3つのパラメータが位置指定であることが示されています。

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 ?`出力で示された順序と同じ順番で指定します。つまり、 `-volume`の値は `-aggregate`の値よりも先に指定し、さらに `-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