知識マップ: PowerShellの並列処理 ── ForEach-Object -Parallelとジョブの使い分け

記事「PowerShellの並列処理 ── ForEach-Object -Parallelとジョブの使い分け」の主張を、概念と関係(エッジ)に分解した知識グラフの全体です。各関係には根拠・確認日・確度が付いています。

PowerShellの並列処理はランスペースという実行環境を複数用意して行われ、ForEach-Object -Parallelは各要素を別ランスペースのスレッドで実行し、呼び出し元の変数は$using:で参照として渡す。書き込みを伴う共有には通常のハッシュテーブルではなくConcurrentDictionaryなどスレッドセーフな型が前提になり、呼び出し元で定義した関数を使うには.psm1モジュール化して各ランスペースで読み込む必要がある。同時実行数はThrottleLimitで制御し、待ち時間が支配的な処理には効果がある一方、1件あたりが軽い処理や少件数の処理には向かずMeasure-Commandでの比較が推奨される。プロセス隔離が必要ならStart-Job、軽量な投げっぱなし処理ならStart-ThreadJobが向き、相手が業務サーバーの場合はThrottleLimitを上げすぎると相手側に過負荷をかけることもある。

flowchart LR
    accTitle: PowerShellの並列処理の知識マップ
    accDescr: ForEach-Object -Parallelがランスペースとusingスコープ修飾子の仕組みの上に成り立ち、ThrottleLimitでの制御やスレッドセーフなコレクション・.psm1モジュール化が必要になる場面、Start-ThreadJob・Start-Job・Invoke-Commandとの使い分け、並列化が効く場面と効かない場面の関係を示す図
    foreach_object_parallel["ForEach-Object -Parallel"]
    runspace["ランスペース(runspace)"]
    using_scope_modifier["$using:スコープ修飾子"]
    throttle_limit["ThrottleLimit"]
    concurrent_collection["スレッドセーフなコレクション型"]
    psm1_module[".psm1スクリプトモジュール"]
    start_threadjob["Start-ThreadJob"]
    start_job["Start-Job"]
    invoke_command_remote["Invoke-Command -ComputerName"]
    trivial_per_item_workload["1件あたりが軽い・少件数のワークロード"]
    io_wait_bound_workload["待ち時間が支配的な処理"]
    measure_command["Measure-Command"]
    process_isolation_required["プロセス隔離が必要な処理"]
    downstream_server_overload["接続先サーバーへの過負荷"]
    foreach_object_parallel -->|"利用する"| runspace
    foreach_object_parallel -.->|"利用する"| using_scope_modifier
    foreach_object_parallel -->|"で構成できる"| throttle_limit
    using_scope_modifier -.->|"前提とする"| concurrent_collection
    foreach_object_parallel -.->|"前提とする"| psm1_module
    start_threadjob -->|"利用する"| runspace
    start_job -.->|"前提とする"| psm1_module
    start_threadjob -.->|"前提とする"| psm1_module
    invoke_command_remote -->|"で構成できる"| throttle_limit
    foreach_object_parallel -->|"用いるのは非推奨"| trivial_per_item_workload
    foreach_object_parallel -->|"推奨される対応"| io_wait_bound_workload
    foreach_object_parallel -->|"で確認できる"| measure_command
    start_job -->|"推奨される対応"| process_isolation_required
    start_threadjob -->|"用いるのは非推奨"| process_isolation_required
    throttle_limit -.->|"原因になり得る"| downstream_server_overload
    invoke_command_remote -.->|"原因になり得る"| downstream_server_overload

概念間の関係(全16件)

図と同じ関係を文章でも列挙します。表示している文と機械可読な意味データ(RDFa)は同じ要素に載っています。確度が「確立した関係」のものは直接の関係として、「条件付きの関係」のものは成立条件つきの言明(rdf:Statement)として表現しています。

ForEach-Object -Parallelはランスペース(runspace)を利用します。ForEach-Object -Parallelは各スクリプトブロックを別のランスペースで実行する / 確度: 確立した関係 / 確認日: 2026-08-01 出典
ForEach-Object -Parallelは$using:スコープ修飾子を利用します。呼び出し元の変数を並列スクリプトブロックへ渡す場合、$using:スコープ修飾子を使う / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
ForEach-Object -ParallelはThrottleLimitで構成できます。同時に実行するスクリプトブロックの数はThrottleLimit(既定5)で構成でき、7.1以降はランスペースプールのサイズになる / 確度: 確立した関係 / 確認日: 2026-08-01 出典
$using:スコープ修飾子はスレッドセーフなコレクション型を前提とします。$using:で渡した値を並列スクリプトブロック側から書き換えるなら、System.Collections.Concurrentのスレッドセーフな型が前提になる。通常のハッシュテーブルやListの同時更新は壊れる / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
ForEach-Object -Parallelは.psm1スクリプトモジュールを前提とします。呼び出し元で定義した関数を並列スクリプトブロック内から使うには、共通処理を.psm1モジュールにして各ランスペースの先頭でImport-Moduleする必要がある / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
Start-ThreadJobはランスペース(runspace)を利用します。Start-ThreadJobは別プロセスではなく同一プロセス内の独立したスレッド(ランスペース)でスクリプトブロックを実行する / 確度: 確立した関係 / 確認日: 2026-08-01 出典
Start-Jobは.psm1スクリプトモジュールを前提とします。Start-Jobのスクリプトブロックも別プロセスの新しいセッションで動くため、呼び出し元の関数を使うにはモジュール化が必要になる / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
Start-ThreadJobは.psm1スクリプトモジュールを前提とします。Start-ThreadJobのスクリプトブロックも別ランスペースで動くため、呼び出し元の関数を使うにはモジュール化が必要になる / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
Invoke-Command -ComputerNameはThrottleLimitで構成できます。同時に接続するコンピューターの台数はThrottleLimit(既定32)で構成できる / 確度: 確立した関係 / 確認日: 2026-08-01 出典
ForEach-Object -Parallelを1件あたりが軽い・少件数のワークロードに用いることは推奨されません。1件あたりの処理が軽い、または件数が少ない処理に並列化を使うと、オーバーヘッドで通常より遅くなり得る / 確度: 確立した関係 / 確認日: 2026-08-01 出典
ForEach-Object -Parallelは待ち時間が支配的な処理に対する本記事の推奨です。ネットワーク待ちやディスクI/O待ちが支配的な処理、マルチコアで意味のある計算処理には並列化の価値がある / 確度: 確立した関係 / 確認日: 2026-08-01 出典
ForEach-Object -ParallelはMeasure-Commandで確認できます。並列化すべきかどうかは、逐次版と並列版をMeasure-Commandで比較して判断する / 確度: 確立した関係 / 確認日: 2026-08-01 出典
Start-Jobはプロセス隔離が必要な処理に対する本記事の推奨です。呼び出し元プロセスを巻き込みたくない処理や32bit/64bitなど実行環境の分離が必要な処理にはStart-Jobが向く / 確度: 確立した関係 / 確認日: 2026-08-01 出典
Start-ThreadJobをプロセス隔離が必要な処理に用いることは推奨されません。Start-ThreadJobは同一プロセス内で動くため、プロセスそのものの隔離が必要な用途には使えない / 確度: 確立した関係 / 確認日: 2026-08-01 出典
ThrottleLimitは接続先サーバーへの過負荷の原因になることがあります。相手が業務サーバーやAPIの場合、ThrottleLimitを自分の都合だけで上げすぎると相手側の同時接続上限やレート制限を超えて障害の加害者になりかねない / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
Invoke-Command -ComputerNameは接続先サーバーへの過負荷の原因になることがあります。台数とForEach-Object -Parallelの並列度を掛け合わせた総負荷が相手側にかかるため、両者を組み合わせるときは特に注意が要る / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典

主要概念の定義

ForEach-Object -Parallel: PowerShell 7.0で追加された、入力の各要素を別のランスペースで並列実行するパラメーターセット。
ランスペース(runspace): PowerShellがスクリプトを実行するための実行環境そのもので、変数・関数・読み込み済みモジュール・カレントディレクトリといったセッションの状態一式を保持する。1つのプロセスの中に複数持てる。
$using:スコープ修飾子: コマンドレットを呼び出したスレッドから、実行中の各スクリプトブロックのスレッドへ変数を渡すための修飾子。同一プロセス内では参照が渡り、別プロセス・別マシンではシリアライズされたコピーが渡る。
Start-ThreadJob: 同一プロセス内の独立したスレッド(ランスペース)でスクリプトブロックを実行する軽量なバックグラウンドジョブコマンドレットで、標準のジョブコマンドレットで扱える。
Start-Job: コマンドを新しいプロセスで非同期に実行する標準のバックグラウンドジョブコマンドレットで、結果はシリアライズを経て呼び出し元に返る。
Invoke-Command -ComputerName: 指定した複数のリモートコンピューターへ同じコマンドを実行するコマンドレットで、-ThrottleLimitの既定値32で同時接続数を制御する。
ThrottleLimit: 同時に実行する数を指定するパラメーターで、ForEach-Object -Parallelではランスペースプールのサイズ(既定5)、Invoke-Commandでは同時接続台数(既定32)を意味する。

機械可読データ

JSON-LD / Turtle ── この記事の知識グラフ全体
概念一覧 / 語彙(述語)の定義

このページはサイトの知識グラフ(_data/knowledge/)から自動生成されています。誤りの指摘はお問い合わせからお願いします。