跳到主要内容

理解位置参数

可利用 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。

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 0cluster1::>  volume  create  -vserver  svm1  vol3  -snapshot-policy  default aggr1  -nvfail  off  1g -space-guarantee none