2022
我们一起努力

Powershell 函数中的CmdletBinding()是怎么回事?

参考文章:

Don Jones https://technet.microsoft.com/en-us/library/ff677563.aspx

powershell 帮助文档: 

help about_functions_advanced_parameters

help about_common_parameters

把这三部分内容都看完了,应该也大概了解函数中的CmdletBinding()是做什么用的了,官方的文档都是英文的,看起来一般会头大。以下就是我用通俗的语言来做的描述,更简单易懂一些。

这个功能的引入是从Powershell Version 2开始的,叫做函数的高级功能,在函数的声明出启用以后,可以调用我们所说的通用参数:

  • -Verbose

  • -Debug

  • -ErrorAction

  • -WarningAction

  • -ErrorVariable

  • -WarningVariable

  • -OutVariable

  • -OutBuffer

  • -PipeLineVariable

通过放在函数开始部分可以很简单的启用访问这些通用参数。如下所示:

[CmdletBinding()]

param()


启用这个高级属性以后,就可以很容易的通过像使用命令行一样,给函数添加一些命令行的特色,调用命令很的通用参数。以下是一个最简单的例子,打开一个ISE,把以下的内容复制下去:

function Go-Advanced {

    [cmdletbinding()]param()

}


param() 这个关键字还是必须要有的,即使你没有在函数中定义任何参数;


尝试运行一下这个函数,然后再打一下中横线,怎么样,就看到能够调用的这些通用参数了吧。


以下举几个例子来调用这些通用参数,先来说说Verbose的用法。

还是在ISE中输入以下代码

Powershell 函数中的CmdletBinding()是怎么回事?

Function GoVerbose {

     [CmdletBinding()]Param()

     WriteVerbose ”Alright, you prefer talkative functions. First of all, I appreciate your wish to learn more about the common parameter -Verbose. Secondly, blah blah..”

     WriteHost ”This is self-explanatory, anyway.”

}

再执行以下,看看是不是以下结果,通过这个例子,你就明白verbose是怎么出来的,这个单词是很难翻译的,只能是通过例子弄明白是什么意思。

再举一个例子,就是调用ShouldContinue这个方法,这个在写程序时还是很重要的,比如你想做一些破坏性的操作,程序写的健壮是一定要跳一个框出来,问一下再去执行,那种SilientContinue做法不推荐。

以下还是代码:

这段代码还是要在函数执行时加一个 -confirm参数的。如果想不加这个参数也要跳出这个框来,这样就需要一个额外的操作。把环境变量$ConfirmPreferece 设置成低。看以下代码和执行效果。

Function RemoveByForce {

     [CmdletBinding(SupportsShouldProcess)]

     Param([String]$File)

 

     $ConfirmPreference = ”Low”

     If ($PSCmdlet.ShouldContinue(”Are you sure that you know what you are doing?”,”Delete with -Force parameter!”)) { 

             RemoveItem $File Force

     } Else { 

             ”Mission aborted!”

     }

}

RemoveByForce test

以上就是两个基本的例子,接下来的文章会讨论

param()中的[parameter()]对变量的影响。

赞(0)
文章名称:《Powershell 函数中的CmdletBinding()是怎么回事?》
文章链接:https://www.fzvps.com/105252.html
本站文章来源于互联网,如有侵权,请联系管理删除,本站资源仅供个人学习交流,请于下载后24小时内删除,不允许用于商业用途,否则法律问题自行承担。
图片版权归属各自创作者所有,图片水印出于防止被无耻之徒盗取劳动成果的目的。

评论 抢沙发

评论前必须登录!