function - 正确使用参数

Question

什么是处理参数的好习惯，我什么时候选择什么选项？

例子:通常我写这样的函数:

function Do-Something ($variable1, $variable2, $variable3....) 
    { Do Stuff }

现在显然这也是一个选择:

Param(
    [Parameter(Position=0,
        Mandatory=$True,
        ValueFromPipeline=$True)]
    [string]$userName,
    ...
)

但是，我不知道为什么要使用第二个，或者使用它的真正优势是什么。

Answer 1

第二个 Param()块允许你做很多高级参数验证。

如果我需要用最少的输入验证编写一个简短的函数，我将使用这样的东西:

Function Test-Port ([string]$Server,[uint16]$Port=80,[uint16]$Timeout = 3000) {
    #code here
}

但是如果我需要写一些像这样的高级检查:

function Get-SiteCert{
    [CmdletBinding(DefaultParameterSetName = "Return")]
    Param(
        [Parameter(Mandatory=$true,Position=0)]
        [string]$Server,
        [Parameter(Position=1)]
        [uint16]$Port=443,
        [Parameter(Mandatory=$false, ParameterSetName="RawObj")]
        [switch]$Raw,
        [Parameter(Mandatory=$false, ParameterSetName="Export")]
        [switch]$Export,
        [Parameter(Mandatory=$true, ParameterSetName="Export")]
        [string]$Path,
        [uint16]$Timeout=3000
    )
    #code here
}

我绝对不会将它们全部放入顶部栏，即使它们是相似的脚本，但第二个“做”更多。这真的只是个案。

您可以查看 this link有关您可以使用扩展参数做什么的示例，但如果您不需要这些，请随意继续使用您喜欢的任何一个。