为什么此函数不适用于管道变量？

Question

我创建了这个函数来解析特定文本的字段并返回一个自定义对象。

如果我使用语法Get-MachineUser -VMArray $PassedArray，一切正常，但如果我通过管道传递数组$PassedArray | Get-MachinesUser，则一切正常。

我与团队中的某个人一起工作，我们发现当我们传递数组时，它只处理数组中的最后一个条目。我不介意使用其他语法，但我很好奇我有什么错误导致管道无法工作。

function Get-MachinesUser{
    param (
        [parameter(Mandatory=$true, ValueFromPipeline=$true)]
        [System.Object[]] $VMArray
    )
    foreach($vm in $VMArray){
        if($VM.Description -match '.*(ut[A-Za-z0-9]{5}).*'){
            [PSCustomObject]@{
            "Name" = $vm.Name  
            "User" = $Matches[1]
            }
        }
    }
}  

Answer 1

要支持管道输入，您需要在函数中添加一个进程块：

function Get-MachinesUser{
    param (
        [parameter(Mandatory=$true, ValueFromPipeline=$true)]
        [System.Object[]] $VMArray
    )
    Process{
        foreach($vm in $VMArray){
            if($VM.Description -match '.*(ut[A-Za-z0-9]{5}).*'){
                [PSCustomObject]@{
                "Name" = $vm.Name  
                "User" = $Matches[1]
                }
            }
        }
    }  
}

流程

此块用于为 功能。这个块可以使用任意次数， 取决于函数的输入。例如，如果函数 是管道中的第一个命令，将使用 Process 块 一度。如果函数不是管道中的第一个命令， Process 块对函数的每个输入使用一次 从管道接收。

来源：https://ss64.com/ps/syntax-function-input.html

（注：由于 SS64 错误地指出在没有管道输入的情况下不会执行进程块，而实际上它仍然执行一次），因此引用已稍作修改。 p>

包含 ForEach 循环仍然是正确的，因为这意味着您在通过参数传递数组输入时支持它。但是，为了在通过管道发送时处理所有输入，需要一个 Process { } 块。