标签:style blog class code java ext
Parameter
在声明cmdlet参数的时候,我们使用了Parameter标识符,在这个标识符中,有些参数需要了解到。
强制参数
设置Mandatory=true即可。
对于强制参数,不管是在命令行中绑定,还是通过管道输入,在命令逻辑执行之前,它就必须绑定好。如果强制参数没有参数值的话,PowerShell会弹出对话框,要求用户提供参数值。
位置参数、
Position= n
有时,我们在使用Powershell的时候,发现仅仅是输入参数值,并没有指定具体参数名,命令依然能够正常执行。
PowerShell支持位置参数,即根据参数的位置进行参数值绑定,这样,在命令行中就不必显示地指定参数名了。
如果使用位置参数,还需要知道位置参数的赋值绑定过程:
1.有名称的先绑定,即在命令行中显示指定了参数名的先绑定
2.PowerShell将命令行中未绑定的参数值放到一个表中,称为”未绑定参数值列表“,其中的参数值按照命令行中出现的位置排列
3.PowerShell将未绑定的位置参数放到一个表中,称为”未绑定位置参数列表“,其中的命令参数按照cmdlet声明中的位置信息进行排列
4.未绑定参数值列表和未绑定位置参数列表逐个进行匹配绑定。如果有多余的未绑定参数值的话,则参数绑定过程报错
剩余参数值参数
ValueFromRemainingArguments = true
这是一个特殊的位置参数,当有名称的参数和位置参数都结束绑定后,剩余参数值参数接受表中的剩余参数值。
很多时候,剩余参数值不止一个,因此剩余参数值参数都定义为数组。
参数集合
ParameterSetName = ”“
通常,cmdlet需要处理各种不同组合中出现的参数。参数集合将参数分为互斥的集合。
但是,使用参数集合时,要注意,如果命令行没有参数值,会导致参数集合解析错误。为了避免这种情况,可以选择一个最一般的参数集合进行绑定,指明为默认参数集合。具体例子见后文。
与参数集合有关的参数绑定,在绑定过程中,PowerShell按照下面步骤判断使用哪一个参数集合
1.有名称的参数绑定
2.位置参数绑定
3.管道参数绑定
参数值验证
参数值验证在绑定之前进行,主要是验证参数值的合法性。当然,也可以自定义参数值验证属性,需要直接或间接继承ValidateArgumentAttribute类,重写ValidateElement方法。
ValueFromPipeline和ValueFromPipelineByPropertyName
相信大家都这么使用过PS命令: cmdlet1 | cmdlet2
将cmdlet1的输出,作为cmdlet2的输入。如果希望实现这样的效果,不妨试一下ValueFromPipeline和ValueFromPipelineByPropertyName
ValueFromPipelin: 如果参数值没有在命令行中指定的话,它可以和管道输入的对象绑定在一起。
ValueFromPipelineByPropertyName:如果参数值没有在命令行中指定的话,它可以和管道输入对象的属性绑定在一起。
以上关于Parameter的介绍到这里,下面用一个具体的例子来看一下。
1 [Cmdlet(VerbsCommon.Get,"SQLServerBackupFile", 2 SupportsShouldProcess = true, ConfirmImpact = ConfirmImpact.Medium, 3 DefaultParameterSetName = "PathInfo")] 4 public class GetSQLServerBackup : PSCmdlet 5 { 6 private string path; 7 8 [Parameter(Mandatory = true, ParameterSetName = "PathInfo" , Position =1, 9 ValueFromPipeline = true, ValueFromPipelineByPropertyName = true)] 10 [ValidateNotNullOrEmpty] 11 public string Path 12 { 13 get { return path; } 14 set { path = value; } 15 } 16 17 private FileInfo fileInfo; 18 19 [Parameter(Mandatory = true, ParameterSetName = "FileInfoSet", Position =1, 20 ValueFromPipeline = true, ValueFromPipelineByPropertyName = true)] 21 public FileInfo FileInfo 22 { 23 get { return fileInfo; } 24 set { fileInfo = value; } 25 } 26 27 private object[] arguments; 28 29 [Parameter(ValueFromRemainingArguments = true)] 30 public object[] Arguments 31 { 32 get { return arguments; } 33 set { arguments = value; } 34 } 35 36 37 protected override void ProcessRecord() 38 { 39 if (Directory.Exists(path)) 40 { 41 if (this.ShouldProcess(path, "Show Specified Directory " + path)) 42 { 43 string[] files = Directory.GetFiles(path); 44 foreach (string itemFile in files) 45 { 46 FileInfo tempInfo = new FileInfo(itemFile); 47 if (tempInfo.Extension.Equals(".bak", StringComparison.OrdinalIgnoreCase)) 48 { 49 WriteObject(tempInfo); 50 } 51 } 52 } 53 } 54 55 if (null != fileInfo) 56 { 57 WriteObject(fileInfo); 58 } 59 } 60 }
标签:style blog class code java ext
原文地址:http://www.cnblogs.com/ByronsHome/p/3721720.html