PowerShell函数非管道传参时数组参数被识别为多行字符串问题

我编写了一个PowerShell函数foo，其中[array]$path参数支持管道输入和属性名传参。当通过参数直接传递多个路径（如执行foo -path 'C:\temp\green', 'C:\temp\blue', 'C:\temp\red'）时，参数被识别为一个整体数组，Begin、Process、End块都会输出所有值；而使用管道传递值时，Process块会逐个处理每个元素。我期望两种传参方式都能让Process块逐个处理每个独立的数组元素，当前环境为Win11/PWSH 7.4。

原函数代码 #

Function foo{
    [CmdletBinding()]
    Param(
    [Parameter(ValueFromPipeline, ValueFromPipelineByPropertyName)]
    [array]$path
    #[string[]]$path    #I tried this too, same issue as above.
    )

    Begin{"---begin---" ; $path}
    Process{"---Process---" ; $path}
    End{"---End---" ; $path}
}

非管道执行输出 #

---begin---
red
blue
green
---Process---
red
blue
green
---End---
red
blue
green

管道执行输出 #

---begin---
---Process---
red
---Process---
blue
---Process---
green
---End---
green

解决方案 #

问题根源在于：直接传递多个路径值时，PowerShell会将所有值打包成一个[array]对象一次性传给$path参数，导致Process块仅执行一次并输出整个数组；而管道传递时，每个元素单独传入$path，Process块会针对每个元素执行一次。

方案1：在Process块中遍历元素（推荐） #

这种方式能统一两种传参的处理逻辑，无论输入是单个值还是数组，都能逐个处理元素：

Function foo{
    [CmdletBinding()]
    Param(
        [Parameter(ValueFromPipeline, ValueFromPipelineByPropertyName)]
        [array]$path
    )

    Begin{"---begin---"}
    Process{
        "---Process---"
        foreach ($item in $path) {
            $item
        }
    }
    End{"---End---"}
}

执行效果

• 非管道执行：foo -path 'C:\temp\green', 'C:\temp\blue', 'C:\temp\red'

---begin---
---Process---
C:\temp\green
C:\temp\blue
C:\temp\red
---End---

• 管道执行：'C:\temp\green', 'C:\temp\blue', 'C:\temp\red' | foo

---begin---
---Process---
C:\temp\green
---Process---
C:\temp\blue
---Process---
C:\temp\red
---End---

方案2：将参数改为非数组类型 #

如果希望直接传递多个值时，Process块也能像管道传递一样执行多次，可以将参数类型改为非数组（如[string]），传递时多次指定-path参数即可：

Function foo{
    [CmdletBinding()]
    Param(
        [Parameter(ValueFromPipeline, ValueFromPipelineByPropertyName, Mandatory=$false)]
        [string]$path
    )

    Begin{"---begin---"}
    Process{
        "---Process---"
        $path
    }
    End{"---End---"}
}

执行foo -path 'C:\temp\green' -path 'C:\temp\blue' -path 'C:\temp\red'时，Process块会执行三次，逐个输出每个路径。

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