了解定位参数

您可以利用 Data ONTAP CLI 的定位参数功能来提高命令输入的效率。您可以查询一个命令以识别该命令的定位参数。

什么是定位参数

注意:不建议在脚本中使用定位参数功能,尤其是当定位参数是命令的可选参数或者在其前面列出了可选参数时。

如何识别定位参数

您可以在 command_name ? 命令输出中识别定位参数。定位参数的参数名称采用以下格式之一括在方括号中:

例如,当如以下 command_name ? 输出中所示时,参数是出现该参数的命令的定位参数:

但是,当如下所示时,参数是出现该参数的命令的非定位参数:

使用定位参数的示例

在以下示例中,volume create ? 输出显示三个参数是命令的定位参数:-volume-aggregate-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 ? 输出中所示的顺序相同。也就是说,按先后顺序依次指定 -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