编写PowerShell函数时，参数应使用单数还是复数命名？

微软官方的PowerShell Cmdlet命名规范里，接受多值的参数统一用单数命名，这是行业通用惯例，比如你提到的Process-VM -VMName，还有Get-Process -Name、Stop-Service -Name都是典型例子。针对你遇到的两个困扰，社区和官方的处理方式如下：

关于foreach循环的语义问题 #

不用纠结foreach ($vm in $VMName)的写法——这是PowerShell社区的常规操作。参数名用单数，代表的是“目标对象的单个标识项”，而非限制输入数量；遍历的时候用单数变量（$vm），刚好对应参数指向的单个实例，完全符合语义逻辑，没人会觉得违和。

关于复数参数的尴尬 #

官方明确不推荐用复数作为参数名，除非是少数必须强调“集合本身”的场景（比如-ExcludeProperties这类本质就是多个属性的集合）。保持单数参数名的好处是：

• 和微软官方Cmdlet的命名风格一致，用户调用时不用额外记忆你的函数是单数还是复数参数
• 避免-VMNames "myvm"这种不符合直觉的写法，单数参数名天然支持单个或多个输入，只要你在函数里把参数类型设为数组（比如[string[]]$VMName），并加上[Parameter(ValueFromPipeline=$true)]支持管道输入即可。

实践示例 #

一个标准的符合规范的函数写法：

function Process-VM {
    [CmdletBinding()]
    param (
        [Parameter(Mandatory=$true, ValueFromPipeline=$true, ValueFromPipelineByPropertyName=$true)]
        [string[]]$VMName
    )

    process {
        foreach ($vm in $VMName) {
            # 处理单个虚拟机的逻辑
            Write-Verbose "Processing VM: $vm"
        }
    }
}

这个函数既支持Process-VM -VMName "myvm"，也支持Process-VM -VMName "vm1", "vm2"，还能通过管道输入Get-VM | Process-VM，完全符合官方规范，也解决了你的语义困扰。

内容的提问来源于stack exchange，提问作者Matthew McDonald