ValidateSet attribútumdeklarációjaValidateSet Attribute Declaration

A ValidateSetAttribute attribútum a parancsmag paraméter argumentumának lehetséges értékeit határozza meg.The ValidateSetAttribute attribute specifies a set of possible values for a cmdlet parameter argument. Ezt az attribútumot a Windows PowerShell functions is használhatja.This attribute can also be used by Windows PowerShell functions.

Ha ez az attribútum meg van adva, a Windows PowerShell-futtatókörnyezet meghatározza, hogy a parancsmag paraméterhez megadott argumentum megegyezik-e a megadott elem készletében szereplő elemmel.When this attribute is specified, the Windows PowerShell runtime determines whether the supplied argument for the cmdlet parameter matches an element in the supplied element set. A parancsmag csak akkor fut, ha a paraméter argumentuma megegyezik a készlet egyik elemével.The cmdlet is run only if the parameter argument matches an element in the set. Ha nem talál egyezést, a Windows PowerShell-futtatókörnyezet hibát jelez.If no match is found, an error is thrown by the Windows PowerShell runtime.

SzintaxisSyntax

[ValidateSetAttribute(params string[] validValues)]
[ValidateSetAttribute(params string[] validValues, Named Parameters)]

ParaméterekParameters

ValidValues (System. String) megadása kötelező.ValidValues (System.String) Required. Megadja a paraméter elemének érvényes értékeit.Specifies the valid parameter element values. Az alábbi minta egy vagy több elem megadását mutatja be.The following sample shows how to specify one element or multiple elements.

[ValidateSetAttribute("Steve")]
[ValidateSetAttribute("Steve","Mary")]

IgnoreCase (System. Boolean) választható elnevezett paraméter.IgnoreCase (System.Boolean) Optional named parameter. Az alapértelmezett érték true azt jelzi, hogy az eset figyelmen kívül lesz hagyva.The default value of true indicates that case is ignored. Az érték a false parancsmag kis-és nagybetűk megkülönböztetését teszi lehetővé.A value of false makes the cmdlet case-sensitive.

MegjegyzésekRemarks

  • Ez az attribútum csak egyszer használható paraméterként.This attribute can be used only once per parameter.

  • Ha a paraméter értéke tömb, a tömb minden elemének meg kell egyeznie az attribútum készletének egy elemével.If the parameter value is an array, every element of the array must match an element of the attribute set.

  • A ValidateSetAttribute attribútumot a System. Management. Automation. ValidateSetAttribute osztály határozza meg.The ValidateSetAttribute attribute is defined by the System.Management.Automation.Validatesetattribute class.

Lásd még:See Also

System. Management. Automation. ValidatesetattributeSystem.Management.Automation.Validatesetattribute

Windows PowerShell-parancsmag írásaWriting a Windows PowerShell Cmdlet