Informationen zu Positionsparametern
Sie können die Positionsparameter-Funktionalität der ONTAP-CLI nutzen, um die Effizienz bei der Befehlseingabe zu steigern. Sie können einen Befehl abfragen, um Parameter zu identifizieren, die für den Befehl positioniert sind.
Was ist ein Positionsparameter
-
Ein Positionsparameter ist ein Parameter, der nicht erfordert, dass Sie den Parameternamen angeben müssen, bevor Sie den Parameterwert angeben.
-
Ein Positionsparameter kann mit nichtpositionalen Parametern in der Befehlseingabe interssert werden, solange er seine relative Reihenfolge mit anderen Positionsparametern im selben Befehl beobachtet, wie in der
command_name ?
Ausgabe angegeben. -
Ein Positionsparameter kann ein erforderlicher oder optionaler Parameter für einen Befehl sein.
-
Ein Parameter kann für einen Befehl positioniert werden, jedoch nicht für einen anderen.
Die Verwendung der Positionsparameterfunktion in Skripten wird nicht empfohlen, insbesondere wenn die Positionsparameter für den Befehl optional sind oder optionale Parameter vor ihnen aufgeführt sind. |
Einen Positionsparameter identifizieren
Sie können einen Positionsparameter in der command_name ?
Befehlsausgabe identifizieren. Ein Positionsparameter hat eckige Klammern um den Parameternamen in einem der folgenden Formate:
-
[
-parameter_name
]parameter_value
Zeigt einen erforderlichen Parameter, der positioniert ist. -
[[
-parameter_name
] ]parameter_value
Zeigt einen optionalen Parameter an, der positioniert ist.
Wenn z. B. in der command_name ?
Ausgabe als folgender Parameter angezeigt wird, ist der Parameter für den Befehl positioniert, in dem er angezeigt wird:
-
[-lif] <lif-name>
-
[[-lif] <lif-name>]
Wenn der Parameter jedoch als folgender angezeigt wird, ist er nicht positioniert für den Befehl, der in angezeigt wird:
-
-lif <lif-name>
-
[-lif <lif-name>]
Beispiele für die Verwendung von Positionsparametern
Im folgenden Beispiel volume create ?
zeigt die Ausgabe, dass drei Parameter für den Befehl -volume
, -aggregate
und positioniert sind -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 ...
Im folgenden Beispiel volume create
wird der Befehl angegeben, ohne die Funktionen der Positionsparameter zu nutzen:
cluster1::> volume create -vserver svm1 -volume vol1 -aggregate aggr1 -size 1g -percent-snapshot-space 0
In den folgenden Beispielen wird die Positionsparameterfunktion verwendet, um die Effizienz der Befehlseingabe zu erhöhen. Die Positionsparameter werden im volume create
Befehl mit nicht-Positionsparametern interssert, und die Positionsparameterwerte werden ohne Parameternamen angegeben. Die Positionsparameter werden in der gleichen Reihenfolge angegeben volume create ?
, die vom Ausgang angezeigt wird. Das heißt, der Wert für -volume
wird vor dem von angegeben -aggregate
, was wiederum vor dem von angegeben ist -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