Як написати сценарій PowerShell, який приймає введення конвеєра?

Я намагаюся написати сценарій PowerShell, який може отримати вхідний конвеєр (і, як очікується, це зробить), але намагаюся щось на зразок

ForEach-Object {
   # do something
}

насправді не працює при використанні сценарію з командного рядка наступним чином:

1..20 | .\test.ps1

Чи є спосіб?

Примітка: Я знаю про функції та фільтри. Це не те, що я шукаю.

Це працює, і є, мабуть, інші способи зробити це:

foreach ($i in $input) {
    $i
}

17:12:42 PS> 1..20 | . \ cmd-input.ps1
1
2
3
- фрагмент -
18
19
20

Шукайте "вхідна змінна Powerhell $", і ви знайдете більше інформації та прикладів.
Тут є пара:
Функції та фільтри PowerShell PowerShell Pro!
(див. розділ "Використання спеціальної змінної PowerShell" $ input "")
"Сценарії, функції та блоки сценаріїв мають доступ до змінної $ input, яка забезпечує перерахування елементів у вхідному конвеєрі."
або
$ input gotchas «Дмитрій PowerBlog PowerShell і далі
" ... в основному $ введення в перечислювач, який забезпечує доступ до конвеєру, який у вас є. "

Для командного рядка PS, а не для командного рядка DOS командного процесора Windows.

У v2 ви також можете прийняти введення конвеєра (за властивістюName або byValue), додати псевдоніми параметрів тощо:

function Get-File{
    param(  
    [Parameter(
        Position=0, 
        Mandatory=$true, 
        ValueFromPipeline=$true,
        ValueFromPipelineByPropertyName=$true)
    ]
    [Alias('FullName')]
    [String[]]$FilePath
    ) 

    process {
       foreach($path in $FilePath)
       {
           Write-Host "file path is: $path"
       }
    }
}


# test ValueFromPipelineByPropertyName 
dir | Get-File

# test ValueFromPipeline (byValue) 

"D:\scripts\s1.txt","D:\scripts\s2.txt" | Get-File

 - or -

dir *.txt | foreach {$_.fullname} | Get-File

Ви можете написати фільтр, який є особливим випадком функції:

filter SquareIt([int]$num) { $_ * $_ }

або ви можете створити подібну функцію приблизно так:

function SquareIt([int]$num) {
  Begin {
    # Executes once before first item in pipeline is processed
  }

  Process {
    # Executes once for each pipeline object
    $_ * $_
  }

  End {
    # Executes once after last pipeline object is processed
  }
}

Вищезазначене працює як визначення інтерактивної функції або якщо скрипт може бути розміщений у вашій глобальній сесії (або іншому сценарії). Однак у вашому прикладі вказано, що ви хочете скрипт, тому тут він знаходиться у сценарії, який можна використовувати безпосередньо (крапка не потрібна):

  --- Contents of test.ps1 ---
  param([int]$num)

  Begin {
    # Executes once before first item in pipeline is processed
  }

  Process {
    # Executes once for each pipeline object
    $_ * $_
  }

  End {
    # Executes once after last pipeline object is processed
  }

У PowerShell V2 це трохи змінюється завдяки "розширеним функціям", які надають функції з тими ж функціями прив'язки параметрів, що й у компільованих командлетах. Див. Цю публікацію в блозі для прикладу відмінностей. Також зверніть увагу, що в цьому випадку розширених функцій ви не використовуєте $ _ для доступу до об'єкта конвеєра. За допомогою розширених функцій об'єкти конвеєра прив'язуються до параметрів так само, як це робиться з командлетом.

Далі наведено найпростіші можливі приклади сценаріїв / функцій, які використовують конвеєрне введення. Кожен поводиться так само, як підведення до командлета "echo".

Як сценарії:

  Begin {
    # Executes once before first item in pipeline is processed
  }

  Process {
    # Executes once for each pipeline object
    echo $_
  }

  End {
    # Executes once after last pipeline object is processed
  }

foreach ($i in $input) {
    $i
}

Як функції:

Function Echo-Pipe {
  Begin {
    # Executes once before first item in pipeline is processed
  }

  Process {
    # Executes once for each pipeline object
    echo $_
  }

  End {
    # Executes once after last pipeline object is processed
  }
}

Function Echo-Pipe2 {
    foreach ($i in $input) {
        $i
    }
}

Напр

PS > . theFileThatContainsTheFunctions.ps1 # This includes the functions into your session
PS > echo "hello world" | Echo-Pipe
hello world
PS > cat aFileWithThreeTestLines.txt | Echo-Pipe2
The first test line
The second test line
The third test line