Foreach-Object

Foreach-Objectは、オブジェクトを順次処理するコマンドです。

エイリアスforeach、%

解説

パイプラインで渡された各オブジェクトに対してスクリプトブロック内の操作を実行します。
データの処理、変換、フィルタリングなど、様々な場面で使用できます。

（構文）: ForEach-Object [-Process] <scriptblock[]> [<CommonParameters>] ForEach-Object [-MemberName] <string> [<CommonParameters>]

【主要パラメータ】
パラメータ	説明
-InputObject オブジェクト	パイプラインを使用せずに、直接オブジェクトを指定して処理を行う
-Begin ｽｸﾘﾌﾟﾄﾌﾞﾛｯｸ	ループの最初に一度だけ実行するスクリプトブロックを指定する
-Process ｽｸﾘﾌﾟﾄﾌﾞﾛｯｸ	各オブジェクトに対して実行するスクリプトブロックを指定する
-End ｽｸﾘﾌﾟﾄﾌﾞﾛｯｸ	ループの最後に一度だけ実行するスクリプトブロックを指定する
-RemainingScripts ｽｸﾘﾌﾟﾄﾌﾞﾛｯｸ	-Processパラメータに指定されたスクリプトブロックの後に実行するスクリプトブロックを指定する
-MemberName メンバー名	指定したメンバー名を持つメソッドを各オブジェクトに対して呼び出す
-ArgumentList 引数	-MemberNameで指定したメソッドに渡す引数を指定する
-WhatIf	実行はせずに実行結果の確認のみ行う
-Confirm	実行前に確認メッセージの表示を行う

共通的なパラメータは「共通パラメータ」をご覧ください。

$arr = @("AAA", "BBB", "CCC) $arr | ForEach-Object{ Write-Host $_ } AAA BBB CCC

1..5 | ForEach-Object { $_ * 2 }

（実行結果）

2 4 6 8 10

Get-ChildItem -Path "D:\test" | ForEach-Object { $_.Name }

Get-Process | ForEach-Object { "$($_.Name) - $($_.CPU)" }

Get-Help Foreach-Object