05.1 表示とデータは別物

01 章の復習 — パイプを流れるのはオブジェクト

01 章で見たとおり、Bash のパイプにはテキスト行が、PowerShell のパイプにはオブジェクトが流れます。ここではそれを実際に確かめます。

Get-Process | Select-Object -First 1

実行すると、次のような表が出ます。

 NPM(K)    PM(M)      WS(M)     CPU(s)      Id  SI ProcessName
 ------    -----      -----     ------      --  -- -----------
     28    18.42      35.66       1.42    9876   1 pwsh

ここが最初の落とし穴

この表を見て「7つの項目を持つデータが返ってきた」と考えると間違いです。実際に返ってきているのは System.Diagnostics.Process というオブジェクトで、プロパティは 100 個近くあります。

表に出ていない Path も、そのまま使えます。

Get-Process | Select-Object -First 1 | Select-Object Name, Path, StartTime

Format-* は最後にだけ使う 重要な罠

Format-Table や Format-List を途中に挟むと、そこでオブジェクトが「表示用の部品」に変換されてしまいます。以降のコマンドはまともに動きません。

# ✗ 動かない — Format-Table の後は表示部品になっている
Get-Process | Format-Table Name, Id | Where-Object { $_.Id -gt 1000 }

# ✓ 絞ってから最後に整形する
Get-Process | Where-Object { $_.Id -gt 1000 } | Format-Table Name, Id

05.2 Get-Member — 自習の起点

この1つを覚えれば独学できる

05.1 で「表示に出ていない情報がある」と分かりました。ではどうやって中身を知るのか。その答えが Get-Member です。

Get-Process | Get-Member

   TypeName: System.Diagnostics.Process

Name                       MemberType     Definition
----                       ----------     ----------
Kill                       Method         void Kill()
Refresh                    Method         void Refresh()
Id                         Property       int Id {get;}
ProcessName                Property       string ProcessName {get;}
StartTime                  Property       datetime StartTime {get;}
CPU                        ScriptProperty System.Object CPU {get=...}
...

出力の読み方

プロパティだけ見たいとき

Get-Process | Get-Member -MemberType Property

# 短縮形（gm は Get-Member のエイリアス）
Get-Process | gm -MemberType Property

実際の型を確認しておく

まず Get-Member、が習慣になれば独学できる

# 知らないコマンドに出会ったとき
Get-Service | Get-Member          # 何が返るか調べる
Get-Service | Select-Object -First 1 | Format-List *   # 実際の値を全部見る

Format-List * はすべてのプロパティを実際の値付きで表示します。Get-Member が「何があるか」なら、Format-List * は「いま何が入っているか」です。2つを組み合わせると、未知のコマンドでもすぐ扱えます。

05.3 絞る・変える・選ぶ

役割分担を先に押さえる

Where-Object — 絞る

# JavaScript
files.filter(f => f.size > 1024)

# PowerShell（スクリプトブロック）
Get-ChildItem | Where-Object { $_.Length -gt 1024 }

# PowerShell（簡易構文 — 比較1つだけならこちらが読みやすい）
Get-ChildItem | Where-Object Length -gt 1024

$_ はいま流れてきた1件を指す自動変数です。$PSItem とも書けますが、$_ のほうが一般的です。

ForEach-Object — 変える

# JavaScript
files.map(f => f.name.toUpperCase())

# PowerShell
Get-ChildItem | ForEach-Object { $_.Name.ToUpper() }

3つのブロックを持てる

1..3 | ForEach-Object -Begin { "開始" } -Process { $_ * 10 } -End { "終了" }
# → 開始 / 10 / 20 / 30 / 終了

-Begin は最初に1回、-End は最後に1回だけ実行されます。集計の初期化と結果出力に使えます。

並列実行 pwsh 7

1..10 | ForEach-Object -Parallel { Start-Sleep 1; $_ } -ThrottleLimit 5

Select-Object — 選ぶ

Get-Process | Select-Object Name, Id, CPU
Get-Process | Select-Object -First 5
Get-Process | Select-Object -Property Name -Unique

-ExpandProperty — 値そのものを取り出す よく使う

# オブジェクトが返る（Name というプロパティを持つ箱）
Get-Process | Select-Object -First 1 -Property Name
# → @{Name=pwsh}

# 値そのものが返る（ただの文字列）
Get-Process | Select-Object -First 1 -ExpandProperty Name
# → pwsh

計算プロパティ — 列を作る

Get-ChildItem | Select-Object Name, @{ Name = 'MB'; Expression = { [math]::Round($_.Length / 1MB, 2) } }

Name（列名）と Expression（値の計算式）のハッシュテーブルを渡すと、その場で新しい列を作れます。N / E と略記もできます。

05.4 並べる・まとめる・数える

集計の3兄弟

Sort-Object — 並べる

Get-ChildItem | Sort-Object Length -Descending
Get-ChildItem | Sort-Object Extension, Name          # 複数キー
Get-Process   | Sort-Object CPU -Descending -Top 5   # 上位だけ

Group-Object — まとめる

返るのは GroupInfo というオブジェクトで、3つのプロパティを持ちます。

# 拡張子ごとの合計サイズを出す
Get-ChildItem -Recurse -File |
    Group-Object Extension |
    ForEach-Object {
        [PSCustomObject]@{
            拡張子 = $_.Name
            件数   = $_.Count
            合計MB = [math]::Round(($_.Group | Measure-Object Length -Sum).Sum / 1MB, 2)
        }
    } | Sort-Object 合計MB -Descending

$_.Group に元のファイルオブジェクトが全部入っているので、そこからさらに集計できます。

Measure-Object — 数える

Get-ChildItem | Measure-Object                                    # 件数だけ
Get-ChildItem | Measure-Object Length -Sum -Average -Maximum      # 集計

Count    : 4
Average  : 43403.5
Sum      : 173614
Maximum  : 48259
Property : Length

組み合わせの実例

# 直近7日に更新された .ps1 を、サイズの大きい順に5件
Get-ChildItem -Recurse -Filter *.ps1 |
    Where-Object { $_.LastWriteTime -gt (Get-Date).AddDays(-7) } |
    Sort-Object Length -Descending |
    Select-Object -First 5 Name, Length, LastWriteTime |
    Format-Table -AutoSize

絞る → 並べる → 選ぶ → 整形するの順です。Format-Table が最後に来ていることに注目してください（05.1 の罠）。

05.5 コマンドの探し方

すべてのコマンドは「動詞-名詞」

Get-Verb | Measure-Object      # → Count: 100
Get-Verb | Where-Object Group -eq 'Common'

Get-Command で探す

Get-Command -Verb Get -Noun Process        # 動詞と名詞で絞る
Get-Command *service*                      # 名前の一部で探す
Get-Command -Module Microsoft.PowerShell.Management

Get-Help で使い方を見る

Get-Help Get-ChildItem                     # 概要
Get-Help Get-ChildItem -Examples           # 使用例だけ（最も実用的）
Get-Help Get-ChildItem -Full               # 全部
Get-Help Get-ChildItem -Online             # ブラウザで公式ドキュメント

未知のコマンドを扱う4ステップ

省略形は3種類ある

ls のような短縮表記には仕組みの異なる3種類があります。混同すると「一覧はどこにあるのか」が分からなくなります。

① コマンドのエイリアス — Get-Alias で一覧できる

Get-Alias                                # 全部見る
Get-Alias ls                             # ls の正体を調べる
Get-Alias -Definition Get-ChildItem      # 逆引き → dir, gci, ls の3つ
Get-Help about_Aliases                   # 公式の解説

初期値は PowerShell 本体に組み込まれています。設定ファイルに書かれているわけではないので、Get-Alias が唯一の確実な一覧です。

5.1 と 7 で中身が違う 実害あり

7 では 19 個のエイリアスが削除されました。特に次の2つは挙動が変わります。

② パラメータのエイリアス — コマンドごとに調べる

(Get-Command Get-ChildItem).Parameters['Recurse'].Aliases
# → s, r

(Get-Command Get-ChildItem).Parameters['LiteralPath'].Aliases
# → PSPath, LP

これは正式に定義された別名なので、前方一致とは違って安定しています。とはいえ読み手に伝わりにくいため、スクリプトでは正式名を使います。

③ パラメータの前方一致 — 一覧が存在しない 危険

パラメータ名は他と区別できるところまで縮められます。ただし一覧はなく、何に解決されるかが状況で変わります。

Get-ChildItem -Rec       # → Recurse に解決される  ✓
Get-ChildItem -Fil       # → Filter に解決される   ✓
Get-ChildItem -F         # → エラー
# Parameter cannot be processed because the parameter name 'F' is ambiguous.
# Possible matches include: -Filter -Force.

結論 — 対話は自由、ファイルは正式名