이 함수는 왜 파이프 된 변수와 함께 작동하지 않습니까?

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 블록은 으로 한 번 사용됩니다. 함수가 파이프 라인의 첫 번째 명령이 아니면 파이프 라인에서 함수 이받는 모든 입력에 대해 프로세스 블록이 한 번 사용됩니다.

자료 : https://ss64.com/ps/syntax-function-input.html

(참고 : SS64 잘못에는 파이프 라인 입력이없는 경우, 실제로는 아직 한 번 실행 반면 프로세스 블록이 실행되지 않은 것으로 표시된 바와 견적 약간 개정되었다).

매개 변수를 전달할 때 배열 입력을 지원한다는 의미이므로 ForEach 루프를 포함해도 문제가 없습니다. 그러나 파이프 라인을 통해 전송 될 때 모든 입력을 처리하려면 Process { } 블록이 필요합니다.