PowerShellの計算プロパティで出力結果を自在に加工する方法

2026年5月21日

使い方

PowerShellを利用してシステム管理や自動化を行う際、コマンドレットから出力される標準的なオブジェクトのプロパティだけでは、要件を満たせない場面が多くあります。

例えば、ファイルサイズをバイト単位ではなくメガバイト単位で表示したい場合や、複数のプロパティを結合して一つの項目として表示したいといった要望は非常に一般的です。

このようなケースで非常に強力な武器となるのが、「計算プロパティ（Calculated Properties）」という機能です。

計算プロパティを使いこなすことで、元のオブジェクトには存在しないカスタム項目を動的に追加し、レポートの視認性を劇的に向上させることが可能になります。

本記事では、計算プロパティの基本的な構文から、実務で役立つ具体的な活用例、さらには効率的なデータ加工のテクニックについて詳しく解説します。

目次 [ close ]

計算プロパティ（Calculated Properties）の基本概念

PowerShellにおける計算プロパティとは、Select-ObjectやFormat-Tableなどのコマンドレットで使用できる、一時的なカスタムプロパティのことです。

通常、コマンドレットを実行するとあらかじめ定義されたプロパティが出力されますが、計算プロパティを使えばその場で独自のロジックに基づいた値を生成できます。

これは、既存のデータを加工して表示するためだけの「仮想的な列」を定義する手法と言い換えることもできるでしょう。

計算プロパティはハッシュテーブル（連想配列）の形式を用いて記述され、特定のキーを指定することで動作を制御します。

基本的には、表示名を決める「Name」キーと、処理内容を記述する「Expression」キーの2つを組み合わせて構成されます。

計算プロパティの基本構文とハッシュテーブルの構造

計算プロパティを定義する際は、@{ }というハッシュテーブルの記法を使用します。

具体的には、以下のようなキーワードをキーとして指定することになります。

Name（またはLabel、L、N）：出力されるプロパティのヘッダー名（列名）を指定します。
Expression（またはE）：値を計算するためのスクリプトブロック { } を記述します。

スクリプトブロック内では、現在処理されているオブジェクトを指す特殊変数 $_ を使用して、元のオブジェクトのプロパティを参照できます。

例えば、プロパティ名を変更するだけの最もシンプルな構文は以下のようになります。

PowerShell

# プロパティ名を「Name」から「ファイル名」に変更して表示する例
Get-ChildItem | Select-Object @{Name='ファイル名'; Expression={$_.Name}}, Length

実行結果

ファイル名          Length
----------          ------
Documents           4096
Sample.txt          1024
Work                0

このように、元のオブジェクトが持つプロパティ名を日本語化したり、別の識別子に変えたりすることが容易に行えます。

実践的な数値加工：ファイルサイズの変換

計算プロパティが最も頻繁に利用される場面の一つが、数値データの単位変換です。

Get-ChildItemなどのコマンドが返すファイルサイズ（Lengthプロパティ）はバイト単位であるため、大きなファイルほど桁数が多くなり直感的に理解しづらくなります。

計算プロパティの中で算術演算を行うことで、GB（ギガバイト）やMB（メガバイト）への変換をリアルタイムで実行できます。

以下の例では、ファイルサイズをMB単位に変換し、さらに小数点以下の桁数を調整しています。

PowerShell

# ファイルサイズをMB単位に変換し、小数点第2位まで表示する
Get-ChildItem -File | Select-Object Name, 
    @{Name='Size_MB'; Expression={[Math]::Round($_.Length / 1MB, 2)}}

実行結果

Name            Size_MB
----            -------
backup.zip      150.25
image.png       2.43
report.pdf      12.8

このコードでは、1MBというPowerShell特有の数値修飾子を利用して計算を行い、[Math]::Roundメソッドで数値を丸めています。

これにより、システム管理者にとって「一目で状況が把握できるレポート」を簡単に作成できるようになります。

文字列の結合と整形による情報の集約

複数の情報を一つのプロパティにまとめたい場合にも、計算プロパティは非常に有効です。

例えば、Active Directoryのユーザー一覧を取得する際に、「苗字」と「名前」という別々のプロパティを結合して「フルネーム」として出力したいケースを想定しましょう。

文字列補完機能（ダブルクォーテーション内での変数展開）を利用することで、柔軟な整形が可能です。

PowerShell

# 仮のオブジェクトを作成してプロパティ結合をシミュレート
$users = @(
    [PSCustomObject]@{FirstName='Taro'; LastName='Tanaka'},
    [PSCustomObject]@{FirstName='Hanako'; LastName='Sato'}
)

$users | Select-Object @{Name='FullName'; Expression={"$($_.LastName) $($_.FirstName)"}}

実行結果

FullName
--------
Tanaka Taro
Sato Hanako

このように、複数のフィールドを自由に組み合わせて新しい列を生成できるため、CSV出力用のデータ作成などにも重宝します。

情報の密度を高め、必要なデータが1つのセルに収まるように加工することは、データの再利用性を高める上で重要です。

条件分岐を取り入れた高度なプロパティ生成

計算プロパティの「Expression」内には、単純な式だけでなく、if文やswitch文などの制御構文を含めることも可能です。

これにより、ステータスコードなどの数値を人間が読みやすい文字列に変換するといったロジックを組み込めます。

以下の例では、プロセスのレスポンス状態を判定し、カスタムメッセージを表示させています。

PowerShell

# プロセスの状態を判定してステータスを表示する
Get-Process | Select-Object Name, 
    @{Name='StatusMsg'; Expression={
        if ($$.Responding) { "稼働中" } else { "停止・応答なし" }
    }} | Select-Object -First 5

実行結果

Name                    StatusMsg
----                    ---------
ApplicationFrameHost    稼働中
browser                 稼働中
conhost                 稼働中
csrss                   稼働中
dwm                     稼働中

この手法を用いれば、「特定の閾値を超えたら警告と表示する」といった条件付きの動的レポートがPowerShell単体で完結します。

外部のツールに頼ることなく、スクリプト内でビジネスロジックを完結させられる点が大きなメリットです。

日付・時刻データのカスタマイズ

PowerShellが扱う DateTime オブジェクトは非常に詳細な情報を持っていますが、そのまま出力するとフォーマットが長すぎて画面を圧迫することがあります。

計算プロパティ内で ToString() メソッドや Get-Date -Format を活用することで、必要な部分だけを抽出して表示できます。

PowerShell

# ファイルの更新日時を「yyyy/MM/dd HH:mm」形式に整形する
Get-ChildItem | Select-Object Name, 
    @{Name='LastWrite'; Expression={$_.LastWriteTime.ToString("yyyy/MM/dd HH:mm")}}

実行結果

Name            LastWrite
----            ---------
Data            2026/01/15 10:30
Logs            2026/05/20 09:00
ReadMe.txt      2026/03/12 18:45

ログファイルの解析や、実行結果の証跡を残す際、このように時刻情報を統一したフォーマットで出力することは保守性を高めるために欠かせません。

計算プロパティを使用する際の注意点とベストプラクティス

非常に便利な計算プロパティですが、多用する際にはいくつか意識すべき点があります。

まず第一に、計算プロパティによって追加された項目は「出力されるその瞬間」にのみ存在する仮想的なものであるということです。

そのため、Select-Object で計算プロパティを作成した後に、そのカスタムプロパティ名を使ってさらにフィルタリング（Where-Object）を行いたい場合は、パイプラインの順序に注意が必要です。

計算プロパティを定義する前にフィルタリングを行う方が、処理のオーバーヘッドを減らすことができ効率的です。

PowerShell

# 非効率な例：計算した後にフィルタリング
Get-ChildItem | Select-Object Name, @{N='MB'; E={$_.Length / 1MB}} | Where-Object MB -gt 10

# 効率的な例：フィルタリングした後に必要な項目だけ計算
Get-ChildItem | Where-Object {$_.Length -gt 10MB} | Select-Object Name, @{N='MB'; E={$_.Length / 1MB}}

また、計算プロパティの Expression 内で複雑すぎる処理を記述すると、スクリプトの可読性が低下します。

もしロジックが数行にわたるほど複雑になる場合は、あらかじめ関数として定義しておくか、別の変数にスクリプトブロックを格納してから参照するようにしましょう。

PowerShell

# スクリプトブロックを変数として定義する
$statusBlock = {
    if ($_.CPU -gt 100) { "高負荷" } else { "正常" }
}

Get-Process | Select-Object Name, @{Name='LoadStatus'; Expression=$statusBlock}

このように整理することで、「何を表示するための計算なのか」が明確になり、後からの修正も容易になります。