Skip to main content
OnCommand Workflow Automation 5.0
Eine neuere Version dieses Produkts ist erhältlich.
Die deutsche Sprachversion wurde als Serviceleistung für Sie durch maschinelle Übersetzung erstellt. Bei eventuellen Unstimmigkeiten hat die englische Sprachversion Vorrang.

Richtlinien für Variablen

Beitragende

Bei der Erstellung eines Befehls oder eines Datenquelltyps müssen Sie die Richtlinien für PowerShell und Perl-Variablen in OnCommand Workflow Automation (WFA) kennen.

PowerShell Variablen

Richtlinien Beispiel

Für Skript-Eingabeparameter:

  • Verwenden Sie Pascal Case.

  • Keine Unterstriche verwenden.

  • Verwenden Sie keine Abkürzungen.

$VolumeName

$AutoDeleteOptions

$Size

Für interne Skriptvariablen:

  • Verwenden Sie die Camel-Hülle.

  • Keine Unterstriche verwenden.

  • Verwenden Sie keine Abkürzungen.

$newVolume

$qtreeName

$time

Für Funktionen:

  • Verwenden Sie Pascal Case.

  • Keine Unterstriche verwenden.

  • Verwenden Sie keine Abkürzungen.

GetVolumeSize

Bei Variablennamen wird die Groß-/Kleinschreibung nicht beachtet. Um die Lesbarkeit zu verbessern, sollten Sie jedoch für denselben Namen keine andere Großschreibung verwenden.

$variable Ist das gleiche wie $Variable.

Variablennamen sollten in einfachem Englisch sein und sich auf die Funktionalität des Skripts beziehen.

Nutzung $name Und nicht $a.

Erklären Sie den Datentyp für jede Variable explizit.

[String]Name

[Int]Größe

Verwenden Sie keine Sonderzeichen (! @ # & % , .) und Leerzeichen.

Keine

Verwenden Sie keine PowerShell reservierten Schlüsselwörter.

Keine

Gruppieren Sie die Eingabeparameter, indem Sie zunächst die obligatorischen Parameter, gefolgt von den optionalen Parametern platzieren.

param(
[parameter(Mandatory=$true)]
[string]$Type,

[parameter(Mandatory=$true)]
[string]$Ip,

[parameter(Mandatory=$false)]
[string]$VolumeName
)

Kommentieren Sie alle Eingabevariablen mit Hilfe von HelpMessage-Anmerkungen mit einer sinnvollen Hilfe-Nachricht.

[parameter(Mandatory=$false,HelpMessage="LUN to map")]
[string]$LUNName

Verwenden Sie „Filer“ nicht als Variablenname, sondern verwenden Sie „Array“.

Keine

Verwenden Sie die Anmerkung ValidateSet in Fällen, in denen das Argument auflistet. Damit wird automatisch der Datentyp „Enum“ für den Parameter angezeigt.

[parameter(Mandatory=$false,HelpMessage="Volume state")]
[ValidateSet("online","offline","restricted")]
[string]$State

Fügen Sie einem Parameter, der mit „_Capacity“ endet, einen Alias hinzu, um anzugeben, dass der Parameter vom Kapazitätstyp ist.

Der Befehl „Create Volume“ verwendet Aliase wie folgt:

[parameter(Mandatory=$false,HelpMessage="Volume increment size in MB")]
[Alias("AutosizeIncrementSize_Capacity")]
[int]$AutosizeIncrementSize

Fügen Sie einem Parameter, der mit „_Password“ endet, einen Alias hinzu, um anzugeben, dass der Parameter einen Kennworttyp hat.

param (
  [parameter(Mandatory=$false, HelpMessage="In order to create an Active Directory machine account for the CIFS server or setup CIFS service for Storage Virtual Machine, you must supply the password of a Windows account with sufficient privileges")]  [Alias("Pwd_Password")]  [string]$ADAdminPassword
)

Perl-Variablen

Richtlinien Beispiel

Für Skript-Eingabeparameter:

  • Verwenden Sie Pascal Case.

  • Keine Unterstriche verwenden.

  • Verwenden Sie keine Abkürzungen.

$VolumeName

$AutoDeleteOptions

$Size

Verwenden Sie keine Abkürzungen für interne Skriptvariablen.

$new_volume

$qtree_name

$time

Verwenden Sie keine Abkürzungen für Funktionen.

get_volume_size

Bei Variablennamen wird die Groß-/Kleinschreibung beachtet. Um die Lesbarkeit zu verbessern, sollten Sie für denselben Namen keine andere Groß-/Kleinschreibung verwenden.

$variable Ist nicht dasselbe wie $Variable.

Variablennamen sollten in einfachem Englisch sein und sich auf die Funktionalität des Skripts beziehen.

Nutzung $name Und nicht $a.

Gruppieren Sie die Eingabeparameter, indem Sie zuerst die obligatorischen Parameter, gefolgt von den optionalen Parametern platzieren.

Keine

In GetOptions Funktion, deklarieren Sie explizit den Datentyp jeder Variable für Eingabeparameter.

GetOptions(
	"Name=s"=>\$Name,
	"Size=i"=>\$Size
)

Verwenden Sie „Filer“ nicht als Variablenname, sondern verwenden Sie „Array“.

Keine

Perl schließt nicht das ein ValidateSet Anmerkung für Aufzählungswerte. Verwenden Sie die expliziten „if“-Anweisungen für Fälle, in denen das Argument aufgezählte Werte erhält.

if
(defined$SpaceGuarantee&&!($SpaceGuaranteeeq'none'

$SpaceGuaranteeeq'volume'

$SpaceGuaranteeeq'file')) { die'Illegal SpaceGuarantee argument: \''.$SpaceGuarantee.'\''; } ----

Alle Perl WFA Befehle müssen das Pragma „strict“ verwenden, um die Verwendung unsicherer Konstrukte für Variablen, Referenzen und Unterroutinen zu entmutigen.

use strict;
# the above is equivalent to
use strictvars;
use strictsubs;
use strictrefs;

Alle Perl WFA Befehle müssen die folgenden Perl Module verwenden:

  • Getopt

    Dies wird zur Angabe von Eingabeparametern verwendet.

  • WFAUtil

    Dies wird für Dienstprogrammfunktionen verwendet, die für die Protokollierung von Befehlen, für die Meldung des Befehlsfortschritts, für die Verbindung zu Array-Controllern usw. bereitgestellt werden.

use Getopt::Long;
use NaServer;
use WFAUtil;