知識マップ: C#（CSharp）でPowerShellを実行して、オブジェクトとして受け取る方法

記事「C#（CSharp）でPowerShellを実行して、オブジェクトとして受け取る方法」の主張を、概念と関係(エッジ)に分解した知識グラフの全体です。各関係には根拠・確認日・確度が付いています。

C#からPowerShellを呼ぶ場合、外部プロセスを起動し標準出力を文字列で読む方法は表示形式に依存し壊れやすいのに対し、PowerShell SDKを使うと結果をPSObjectのコレクションとして受け取れ、BaseObjectで元の.NETオブジェクトを、Propertiesで列名を指定した値を取り出せる。C#に渡すならFormat-Tableではなく、Select-Objectや[pscustomobject]で列を整えるべきで、ユーザー入力はAddScriptへ文字列連結せずAddCommand/AddParameterでパラメーター値として渡しコード注入を避ける。画面アプリではInvokeAsyncで非同期実行しつつ、CancellationTokenの登録はパイプライン起動より後に行わないと停止要求が空振りする。実行中の同一インスタンスへの再Invokeは例外になるため、並行実行にはRunspacePoolを使う。

flowchart LR
    accTitle: C#からPowerShellをPSObjectとして実行する知識マップ
    accDescr: PowerShell SDKを使うとPowerShellの実行結果を文字列ではなくPSObjectとして受け取れること、BaseObjectとPropertiesの使い分け、AddParameterによるコード注入の回避、Select-ObjectとFormat-Tableの使い分け、InvokeAsyncでのキャンセルとRunspacePoolによる並行実行の要点を示す図
    powershell_sdk["PowerShell SDK(System.Management.Automation.PowerShell)"]
    psobject["PSObject"]
    addcommand_addparameter["AddCommand/AddParameter"]
    addscript["AddScript"]
    csharp_side_result_processing["C#側で結果を加工する処理"]
    psobject_baseobject["PSObject.BaseObject"]
    psobject_properties["PSObject.Properties"]
    format_table["Format-Table/Format-List"]
    select_object["Select-Object"]
    pscustomobject["[pscustomobject]"]
    user_input_to_powershell["PowerShellへユーザー入力を渡す要件"]
    script_injection_risk["スクリプト注入リスク"]
    invokeasync["PowerShell.InvokeAsync"]
    windows_powershell_5_1["Windows PowerShell 5.1"]
    begininvoke_endinvoke["BeginInvoke/EndInvoke"]
    dotnet_framework[".NET Framework"]
    pipeline_stop_api["パイプライン停止API(Stop/BeginStop/EndStop)"]
    pipelinestoppedexception["PipelineStoppedException"]
    runspacepool["RunspacePool"]
    concurrent_powershell_execution["複数のPowerShell処理を並行実行したい要件"]
    erroraction_stop["ErrorAction Stop"]
    process_based_powershell_invocation["外部プロセスとしてのPowerShell起動"]
    cancellable_pipeline_pattern["CancellationTokenでパイプラインを安全に止める実装パターン"]
    cancellationtoken_dotnet["CancellationToken(.NET)"]
    premature_cancellation_registration["パイプライン起動より前のキャンセル登録"]
    cancellation_race_miss["登録と起動の間のキャンセル空振り"]
    powershell_sdk -->|"利用する"| psobject
    powershell_sdk -->|"利用する"| addcommand_addparameter
    powershell_sdk -->|"利用する"| addscript
    csharp_side_result_processing -->|"利用する"| psobject_baseobject
    csharp_side_result_processing -->|"利用する"| psobject_properties
    format_table -->|"用いるのは非推奨"| csharp_side_result_processing
    select_object -->|"推奨される対応"| csharp_side_result_processing
    pscustomobject -->|"推奨される対応"| csharp_side_result_processing
    addcommand_addparameter -->|"推奨される対応"| user_input_to_powershell
    addscript -.->|"原因になり得る"| script_injection_risk
    addcommand_addparameter -->|"防止する"| script_injection_risk
    powershell_sdk -->|"利用する"| invokeasync
    windows_powershell_5_1 -->|"両立しない"| invokeasync
    windows_powershell_5_1 -->|"利用する"| begininvoke_endinvoke
    dotnet_framework -.->|"利用する"| windows_powershell_5_1
    powershell_sdk -->|"利用する"| pipeline_stop_api
    pipeline_stop_api -->|"原因になり得る"| pipelinestoppedexception
    runspacepool -->|"推奨される対応"| concurrent_powershell_execution
    powershell_sdk -.->|"用いるのは非推奨"| concurrent_powershell_execution
    powershell_sdk -->|"で構成できる"| erroraction_stop
    process_based_powershell_invocation -->|"用いるのは非推奨"| csharp_side_result_processing
    powershell_sdk -->|"推奨される対応"| csharp_side_result_processing
    cancellable_pipeline_pattern -->|"利用する"| pipeline_stop_api
    cancellable_pipeline_pattern -->|"利用する"| cancellationtoken_dotnet
    premature_cancellation_registration -->|"原因になり得る"| cancellation_race_miss
    cancellable_pipeline_pattern -->|"防止する"| cancellation_race_miss

概念間の関係(全26件)

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

PowerShell SDK(System.Management.Automation.PowerShell)はPSObjectを利用します。PowerShell SDKでパイプラインをInvokeした結果は、基本的にCollection<PSObject>やPSDataCollection<PSObject>として返る。 / 確度: 確立した関係 / 確認日: 2026-08-01 出典
PowerShell SDK(System.Management.Automation.PowerShell)はAddCommand/AddParameterを利用します。PowerShellオブジェクトに対してAddCommandとAddParameterを呼ぶことで、コマンドとパラメーターを組み立てて実行する。 / 確度: 確立した関係 / 確認日: 2026-08-01 出典
PowerShell SDK(System.Management.Automation.PowerShell)はAddScriptを利用します。固定の短いスクリプトを実行する場合や、既存スクリプトを読み込む場合はAddScriptを使う。 / 確度: 確立した関係 / 確認日: 2026-08-01 出典
C#側で結果を加工する処理はPSObject.BaseObjectを利用します。PowerShellが返した元の.NETオブジェクトをそのまま使いたい場合はBaseObjectを見る。 / 確度: 確立した関係 / 確認日: 2026-08-01 出典
C#側で結果を加工する処理はPSObject.Propertiesを利用します。Select-Objectや[pscustomobject]で整形した列を取り出したい場合はPropertiesを列名で参照する。 / 確度: 確立した関係 / 確認日: 2026-08-01 出典
Format-Table/Format-ListをC#側で結果を加工する処理に用いることは推奨されません。C#側で受け取る前にFormat-Table/Format-Listを使うと、結果が元のオブジェクトではなく表示用のフォーマット情報になり、プロパティとして値を取り出せなくなる。 / 確度: 確立した関係 / 確認日: 2026-08-01 出典
Select-ObjectはC#側で結果を加工する処理に対する本記事の推奨です。C#で後続処理に使う場合は、Format-Table系ではなくSelect-Objectで列を絞った結果を渡すのが推奨される。 / 確度: 確立した関係 / 確認日: 2026-08-01 出典
[pscustomobject]はC#側で結果を加工する処理に対する本記事の推奨です。複数の値をまとめて返したい場合は[pscustomobject]で整形すると、C#側でPropertiesから名前で値を取り出しやすい。 / 確度: 確立した関係 / 確認日: 2026-08-01 出典
AddCommand/AddParameterはPowerShellへユーザー入力を渡す要件に対する本記事の推奨です。PowerShellコマンドに値を渡す場合は、できるだけAddCommandとAddParameterを使うことが推奨される。 / 確度: 確立した関係 / 確認日: 2026-08-01 出典
AddScriptはスクリプト注入リスクの原因になることがあります。ユーザー入力を文字列連結でAddScriptのスクリプトに埋め込むと、その入力がPowerShellのコードとして解釈される余地がある。 / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
AddCommand/AddParameterはスクリプト注入リスクを防ぎます。AddParameterで渡した値はコード文字列として連結されるのではなくパラメーター値として扱われるため、スクリプト注入の余地がない。 / 確度: 確立した関係 / 確認日: 2026-08-01 出典
PowerShell SDK(System.Management.Automation.PowerShell)はPowerShell.InvokeAsyncを利用します。現行の.NET向けPowerShell SDKでは、InvokeAsyncでパイプラインを非同期実行しそのままawaitできる。 / 確度: 確立した関係 / 確認日: 2026-08-01 出典
Windows PowerShell 5.1はPowerShell.InvokeAsyncと両立しません。Windows PowerShell 5.1向けの参照アセンブリにはInvokeAsyncが無く、BeginInvoke/EndInvokeに分けて非同期化する必要がある。 / 確度: 確立した関係 / 確認日: 2026-08-01 出典
Windows PowerShell 5.1はBeginInvoke/EndInvokeを利用します。InvokeAsyncが使えないWindows PowerShell 5.1環境では、BeginInvoke/EndInvokeをTaskに包んで非同期化する。 / 確度: 確立した関係 / 確認日: 2026-08-01 出典
.NET FrameworkはWindows PowerShell 5.1を利用します。.NET FrameworkのWinFormsやWPFアプリからPowerShellを呼ぶ場合は、Microsoft.PowerShell.5.1.ReferenceAssembliesを介してWindowsに同梱のWindows PowerShell 5.1を実行する。 / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
PowerShell SDK(System.Management.Automation.PowerShell)はパイプライン停止API(Stop/BeginStop/EndStop)を利用します。PowerShellの停止APIには同期のStop、非同期のBeginStop/EndStopがあり、UIスレッドから止める場合は非同期版を使う。 / 確度: 確立した関係 / 確認日: 2026-08-01 出典
パイプライン停止API(Stop/BeginStop/EndStop)はPipelineStoppedExceptionの原因になることがあります。停止すると、待っているInvokeAsync/Invokeの呼び出しはPipelineStoppedExceptionを投げる。これは失敗ではなく正常な経路として扱う。 / 確度: 確立した関係 / 確認日: 2026-08-01 出典
RunspacePoolは複数のPowerShell処理を並行実行したい要件に対する本記事の推奨です。並行実行する数が増えるならRunspacePoolを用意し、PowerShellインスタンスはそこから使い回す。 / 確度: 確立した関係 / 確認日: 2026-08-01 出典
PowerShell SDK(System.Management.Automation.PowerShell)を複数のPowerShell処理を並行実行したい要件に用いることは推奨されません。1つのPowerShellインスタンスを複数スレッドで共有する場合に限り、実行中のインスタンスへ再度Invoke/InvokeAsyncを呼ぶと「コマンドが既に開始されている」という理由でInvalidOperationExceptionになる。RunspacePoolからインスタンスを1つずつ取り出して使う並行実行は本文が実演しているとおり問題ない / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
PowerShell SDK(System.Management.Automation.PowerShell)はErrorAction Stopで構成できます。AddParameterでErrorActionにStopを指定すると、処理を続けるはずの非終了エラーも例外として扱えるようになる。 / 確度: 確立した関係 / 確認日: 2026-08-01 出典
外部プロセスとしてのPowerShell起動をC#側で結果を加工する処理に用いることは推奨されません。標準出力を文字列として読む方法は表示形式(列幅・ロケール・区切り文字)に依存して壊れやすく、C#側で結果を加工する処理には向かない。 / 確度: 確立した関係 / 確認日: 2026-08-01 出典
PowerShell SDK(System.Management.Automation.PowerShell)はC#側で結果を加工する処理に対する本記事の推奨です。C#側で結果を加工する処理、管理ツール、業務アプリでは、結果をPSObjectとして受け取れるPowerShell SDKの利用が推奨される。 / 確度: 確立した関係 / 確認日: 2026-08-01 出典
CancellationTokenでパイプラインを安全に止める実装パターンはパイプライン停止API(Stop/BeginStop/EndStop)を利用します。安全にキャンセルする実装は、CancellationTokenのコールバックからBeginStop/EndStopを呼ぶ形でパイプライン停止APIを使う。 / 確度: 確立した関係 / 確認日: 2026-08-01 出典
CancellationTokenでパイプラインを安全に止める実装パターンはCancellationToken(.NET)を利用します。呼び出し側が途中で止められるように、パイプラインを起動するメソッドはCancellationTokenを受け取り、Registerで停止処理を仕込む。 / 確度: 確立した関係 / 確認日: 2026-08-01 出典
パイプライン起動より前のキャンセル登録は登録と起動の間のキャンセル空振りの原因になることがあります。CancellationToken.Registerは既にキャンセル済みのトークンだとその場でコールバックを実行するため、パイプライン起動より前に登録すると、まだ始まっていないパイプラインへBeginStopが空振りし、その後の起動を誰も止められなくなる。 / 確度: 確立した関係 / 確認日: 2026-08-01 出典
CancellationTokenでパイプラインを安全に止める実装パターンは登録と起動の間のキャンセル空振りを防ぎます。先にキャンセル済みかどうかを確認し、パイプラインを起動してから停止のコールバックを登録する順序にすることで、登録と起動の間のキャンセル空振りを防げる。 / 確度: 確立した関係 / 確認日: 2026-08-01 出典

主要概念の定義

PowerShell SDK(System.Management.Automation.PowerShell): PowerShellのパイプラインをホストアプリ(C#など)のコードから組み立てて実行できる.NETのクラスで、実行結果を文字列ではなくPSObjectのコレクションとして受け取れる。
PSObject: PowerShellが出力する値を包むラッパーオブジェクトで、元の.NETオブジェクト(BaseObject)とプロパティの集合(Properties)を保持する。
C#側で結果を加工する処理: PowerShellの実行結果をC#側でプロパティや型として扱い、画面表示や業務ロジックに使う処理。
Format-Table/Format-List: PowerShellの結果を画面表示用に整形するコマンドレットで、通すと結果が元のオブジェクトではなく表示用のフォーマット情報に変わる。
Select-Object: PowerShellのパイプラインで必要な列だけに絞り込むコマンドレットで、結果はオブジェクトのまま後続処理に渡せる。
[pscustomobject]: PowerShellスクリプト側で複数の値を名前付きのプロパティとしてまとめて返すための構文。
AddCommand/AddParameter: PowerShellオブジェクトにコマンド名とパラメーターを順に追加してパイプラインを組み立てる、PowerShell SDKのメソッド群。渡した値はコード文字列としてではなくパラメーター値として扱われる。
AddScript: PowerShellのスクリプト文字列をそのままパイプラインに追加して実行する、PowerShell SDKのメソッド。
Windows PowerShell 5.1: Windowsに標準で同梱されている、.NET Framework上に構築されたレガシー世代のPowerShell(5.1系)のランタイム。実行ファイルはpowershell.exeで、.NETアプリからはMicrosoft.PowerShell.5.1.ReferenceAssembliesを介して呼び出せる。
.NET Framework: Windowsのコンポーネントとして扱われ、インストールされているOSのライフサイクルに沿ってサポートされるランタイム。System.Messagingの対象範囲。
パイプライン停止API(Stop/BeginStop/EndStop): 実行中のPowerShellパイプラインを止めるためのAPI群。同期のStopは停止し終わるまで戻らず、非同期のBeginStop/EndStopはUIスレッドを待たせずに停止を要求できる。
RunspacePool: 複数のPowerShellインスタンスから使い回せる実行空間(Runspace)のプールで、並行実行の際にRunspaceの都度生成コストを避けられる。
外部プロセスとしてのPowerShell起動: ProcessStartInfoでpowershell.exe/pwsh.exeを外部プロセスとして起動し、標準出力・標準エラーを文字列として読み取る方法。
CancellationTokenでパイプラインを安全に止める実装パターン: パイプラインを起動した後にCancellationToken.Registerで停止(BeginStop/EndStop)を仕込み、停止の完了を待ってからPowerShellインスタンスを破棄する実装パターン。
パイプライン起動より前のキャンセル登録: CancellationToken.Registerによる停止コールバックの登録を、InvokeAsync等でパイプラインを起動するより前に行ってしまう実装。

機械可読データ

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

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