Cmdlet开发与学习(五)

      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的介绍到这里，下面用一个具体的例子来看一下。

      

[Cmdlet(VerbsCommon.Get,"SQLServerBackupFile", 
        SupportsShouldProcess = true, ConfirmImpact = ConfirmImpact.Medium,
        DefaultParameterSetName = "PathInfo")]
    public class GetSQLServerBackup : PSCmdlet
    {
        private string path;

        [Parameter(Mandatory = true, ParameterSetName = "PathInfo" , Position =1,
            ValueFromPipeline = true, ValueFromPipelineByPropertyName = true)]
        [ValidateNotNullOrEmpty]
        public string Path
        {
            get { return path; }
            set { path = value; }
        }

        private FileInfo fileInfo;

        [Parameter(Mandatory = true, ParameterSetName = "FileInfoSet", Position =1,
            ValueFromPipeline = true, ValueFromPipelineByPropertyName = true)]
        public FileInfo FileInfo
        {
            get { return fileInfo; }
            set { fileInfo = value; }
        }

        private object[] arguments;

        [Parameter(ValueFromRemainingArguments = true)]
        public object[] Arguments
        {
            get { return arguments; }
            set { arguments = value; }
        }
        

        protected override void ProcessRecord()
        {
            if (Directory.Exists(path))
            {
                if (this.ShouldProcess(path, "Show Specified Directory " + path))
                {
                    string[] files = Directory.GetFiles(path);
                    foreach (string itemFile in files)
                    {
                        FileInfo tempInfo = new FileInfo(itemFile);
                        if (tempInfo.Extension.Equals(".bak", StringComparison.OrdinalIgnoreCase))
                        {
                            WriteObject(tempInfo);
                        }
                    }
                }
            }

            if (null != fileInfo)
            {
                WriteObject(fileInfo);
            }
        }
    }