この記事は以下のシリーズの19番目の記事です。
この記事でやること
この記事では、PowerShellで取得した一覧を見やすく整形する方法を整理します。
前回の記事では、Where-Object を使って条件に合うファイルだけを抽出しました。
今回は、その結果を次のように整えます。
| やりたいこと | 使うコマンド |
|---|---|
| 必要な項目だけ表示する | Select-Object |
| 更新日時やサイズで並べる | Sort-Object |
| 拡張子やフォルダごとに集計する | Group-Object |
PowerShellでは、次のような流れがよく使われます。
Get-ChildItem -File -Recurse |
Where-Object { $_.Extension -eq ".log" } |
Sort-Object LastWriteTime -Descending |
Select-Object Name, FullName, LastWriteTime
考え方は、次の通りです。
集める → 絞る → 並べる → 必要な項目だけ表示する
まず結論
ファイル一覧を整形する基本形は、次の通りです。
Get-ChildItem -File -Recurse |
Select-Object Name, FullName, Extension, Length, LastWriteTime
更新日時の新しい順に並べるなら、次のようにします。
Get-ChildItem -File -Recurse |
Sort-Object LastWriteTime -Descending |
Select-Object Name, FullName, LastWriteTime
拡張子ごとに件数を集計するなら、次のようにします。
Get-ChildItem -File -Recurse |
Group-Object Extension |
Select-Object Name, Count
実務では、この3つを使えるだけで、ファイル調査・ログ調査・共有フォルダ整理がかなり楽になります。
検証用フォルダを作る
まず、検証用フォルダを作成します。
New-Item -ItemType Directory -Path "C:\work\ps-format-test" -Force
Set-Location "C:\work\ps-format-test"
検証用ファイルを作成します。
Set-Content -Path ".\sample1.txt" -Value "text file 1"
Set-Content -Path ".\sample2.txt" -Value "text file 2"
Set-Content -Path ".\app.log" -Value "application log"
Set-Content -Path ".\error.log" -Value "error log"
Set-Content -Path ".\data.csv" -Value "id,name"
サブフォルダも作成します。
New-Item -ItemType Directory -Path ".\sub" -Force
Set-Content -Path ".\sub\subsample.txt" -Value "sub folder text"
Set-Content -Path ".\sub\sublog.log" -Value "sub folder log"
Set-Content -Path ".\sub\report.csv" -Value "report"
確認します。
Get-ChildItem -Recurse
Select-Objectで必要な項目だけ取り出す
Select-Object は、必要な項目だけを取り出すコマンドです。
まず、普通にファイル一覧を取得します。
Get-ChildItem -File -Recurse
この結果には、ファイル名、サイズ、更新日時、属性など、さまざまな情報が含まれています。
必要な項目だけを表示するには、Select-Object を使います。
Get-ChildItem -File -Recurse |
Select-Object Name, FullName, Extension, Length, LastWriteTime
よく使う項目は次の通りです。
| 項目 | 内容 |
|---|---|
| Name | ファイル名 |
| FullName | フルパス |
| DirectoryName | 親フォルダ |
| Extension | 拡張子 |
| Length | ファイルサイズ |
| CreationTime | 作成日時 |
| LastWriteTime | 更新日時 |
ファイル調査では、まずこの形を覚えると便利です。
Get-ChildItem -File -Recurse |
Select-Object Name, FullName, Length, LastWriteTime
表示する項目の順番を変える
Select-Object では、指定した順番で項目が表示されます。
Get-ChildItem -File -Recurse |
Select-Object LastWriteTime, Name, FullName
この場合、更新日時、ファイル名、フルパスの順に表示されます。
CSVに出力するときも、この順番が列の順番になります。
Get-ChildItem -File -Recurse |
Select-Object LastWriteTime, Name, FullName |
Export-Csv -Path ".\file_list.csv" -NoTypeInformation -Encoding UTF8
Excelで見ることを前提にするなら、列の順番を意識しておくと見やすくなります。
計算した列を追加する
Length はバイト単位です。
そのままだと分かりにくいので、KBやMBに変換した列を追加できます。
Get-ChildItem -File -Recurse |
Select-Object Name,
FullName,
@{Name="SizeKB"; Expression={[math]::Round($_.Length / 1KB, 2)}},
LastWriteTime
この部分で、SizeKB という列を作っています。
@{Name="SizeKB"; Expression={[math]::Round($_.Length / 1KB, 2)}}
MBで表示する場合は、次のようにします。
Get-ChildItem -File -Recurse |
Select-Object Name,
FullName,
@{Name="SizeMB"; Expression={[math]::Round($_.Length / 1MB, 2)}},
LastWriteTime
共有フォルダ調査では、Length よりも SizeMB の方が見やすいことが多いです。
Sort-Objectで並べ替える
Sort-Object は、一覧を並べ替えるコマンドです。
ファイル名順に並べる場合です。
Get-ChildItem -File -Recurse |
Sort-Object Name |
Select-Object Name, FullName
更新日時の古い順に並べる場合です。
Get-ChildItem -File -Recurse |
Sort-Object LastWriteTime |
Select-Object Name, FullName, LastWriteTime
更新日時の新しい順に並べる場合は、-Descending を付けます。
Get-ChildItem -File -Recurse |
Sort-Object LastWriteTime -Descending |
Select-Object Name, FullName, LastWriteTime
ファイルサイズの大きい順に並べる場合です。
Get-ChildItem -File -Recurse |
Sort-Object Length -Descending |
Select-Object Name,
FullName,
@{Name="SizeKB"; Expression={[math]::Round($_.Length / 1KB, 2)}}
大きなファイルを探したいときは、この形が便利です。
複数条件で並べ替える
Sort-Object は、複数の項目で並べ替えることもできます。
拡張子順に並べ、その中でファイル名順に並べる例です。
Get-ChildItem -File -Recurse |
Sort-Object Extension, Name |
Select-Object Extension, Name, FullName
拡張子順に並べ、その中で更新日時の新しい順に並べたい場合は、少し書き方を変えます。
Get-ChildItem -File -Recurse |
Sort-Object Extension, @{Expression="LastWriteTime"; Descending=$true} |
Select-Object Extension, Name, LastWriteTime, FullName
実務では、まず単純な並べ替えから使えば十分です。
よく使うのは次の3つです。
Sort-Object Name
Sort-Object LastWriteTime -Descending
Sort-Object Length -Descending
Group-Objectで件数を集計する
Group-Object は、同じ値ごとにグループ化して集計するコマンドです。
拡張子ごとに件数を集計します。
Get-ChildItem -File -Recurse |
Group-Object Extension
見やすくするなら、Select-Object で Name と Count だけ取り出します。
Get-ChildItem -File -Recurse |
Group-Object Extension |
Select-Object Name, Count
出力イメージは次のようになります。
Name Count
---- -----
.csv 2
.log 3
.txt 3
これは、共有フォルダの中にどの種類のファイルが多いかを調べるときに便利です。
フォルダごとに件数を集計する
親フォルダごとのファイル件数を集計する場合です。
Get-ChildItem -File -Recurse |
Group-Object DirectoryName |
Select-Object Name, Count
Name にはフォルダパスが入ります。
Count には、そのフォルダにあるファイル数が入ります。
フォルダごとのファイル数を調査したい場合に使えます。
拡張子ごとの合計サイズを出す
Group-Object でグループ化したあと、合計サイズを出すこともできます。
Get-ChildItem -File -Recurse |
Group-Object Extension |
Select-Object Name,
Count,
@{Name="TotalSizeMB"; Expression={[math]::Round(($_.Group | Measure-Object Length -Sum).Sum / 1MB, 2)}}
ここでは、拡張子ごとに次の情報を出しています。
| 項目 | 内容 |
|---|---|
| Name | 拡張子 |
| Count | ファイル数 |
| TotalSizeMB | 合計サイズMB |
Group-Object の結果には、Group というプロパティがあります。
その中に、同じグループに属するファイルの一覧が入っています。
$_.Group
その Group に対して Measure-Object Length -Sum を使い、サイズを合計しています。
Measure-Objectで合計や平均を出す
合計サイズだけを見たい場合は、Measure-Object を使います。
Get-ChildItem -File -Recurse |
Measure-Object Length -Sum
ファイル数、合計、平均などを見たい場合です。
Get-ChildItem -File -Recurse |
Measure-Object Length -Sum -Average -Maximum -Minimum
ファイルサイズの合計をMBで見やすくするなら、次のようにします。
$result = Get-ChildItem -File -Recurse |
Measure-Object Length -Sum
[math]::Round($result.Sum / 1MB, 2)
Group-Object と Measure-Object を組み合わせると、拡張子別・フォルダ別の容量調査に使えます。
条件抽出してから整形する
前回の Where-Object と組み合わせると、条件に合うものだけを整形できます。
30日以上更新されていないファイルを、新しい順に並べて表示します。
Get-ChildItem -File -Recurse |
Where-Object { $_.LastWriteTime -lt (Get-Date).AddDays(-30) } |
Sort-Object LastWriteTime -Descending |
Select-Object Name, FullName, LastWriteTime
10MB以上のファイルを、大きい順に並べて表示します。
Get-ChildItem -File -Recurse |
Where-Object { $_.Length -ge 10MB } |
Sort-Object Length -Descending |
Select-Object Name,
FullName,
@{Name="SizeMB"; Expression={[math]::Round($_.Length / 1MB, 2)}},
LastWriteTime
.log ファイルだけを拡張子ごとに集計する例です。
この場合は拡張子が同じなので、あまり意味はありませんが、流れの例としては次のようになります。
Get-ChildItem -File -Recurse |
Where-Object { $_.Extension -eq ".log" } |
Group-Object Extension |
Select-Object Name, Count
CSVに出力する
整形した一覧は、CSVに出力すると実務で使いやすくなります。
ファイル一覧をサイズの大きい順にCSV出力する例です。
Get-ChildItem -File -Recurse |
Sort-Object Length -Descending |
Select-Object Name,
FullName,
Extension,
@{Name="SizeMB"; Expression={[math]::Round($_.Length / 1MB, 2)}},
LastWriteTime |
Export-Csv -Path ".\file_size_list.csv" -NoTypeInformation -Encoding UTF8
拡張子ごとの件数と合計サイズをCSVに出力する例です。
Get-ChildItem -File -Recurse |
Group-Object Extension |
Select-Object Name,
Count,
@{Name="TotalSizeMB"; Expression={[math]::Round(($_.Group | Measure-Object Length -Sum).Sum / 1MB, 2)}} |
Export-Csv -Path ".\extension_summary.csv" -NoTypeInformation -Encoding UTF8
Excelで開く前提なら、環境に応じて utf8BOM や Default を検討します。
Export-Csv -Path ".\extension_summary.csv" -NoTypeInformation -Encoding utf8BOM
実務で使いやすいテンプレート1：大きいファイル一覧
共有フォルダから大きいファイルを探すテンプレートです。
$targetDir = Join-Path $PSScriptRoot "target"
$outputDir = Join-Path $PSScriptRoot "output"
New-Item -ItemType Directory -Path $outputDir -Force | Out-Null
$today = Get-Date -Format "yyyyMMdd"
$outputPath = Join-Path $outputDir "large_files_$today.csv"
Get-ChildItem -Path $targetDir -File -Recurse |
Where-Object { $_.Length -ge 10MB } |
Sort-Object Length -Descending |
Select-Object Name,
FullName,
Extension,
@{Name="SizeMB"; Expression={[math]::Round($_.Length / 1MB, 2)}},
LastWriteTime |
Export-Csv -Path $outputPath -NoTypeInformation -Encoding UTF8
このテンプレートでは、次の処理をしています。
target配下のファイルを集める
10MB以上に絞る
サイズの大きい順に並べる
必要な項目だけ選ぶ
CSVに出力する
実務で使いやすいテンプレート2：拡張子別集計
共有フォルダ内のファイルを拡張子別に集計するテンプレートです。
$targetDir = Join-Path $PSScriptRoot "target"
$outputDir = Join-Path $PSScriptRoot "output"
New-Item -ItemType Directory -Path $outputDir -Force | Out-Null
$today = Get-Date -Format "yyyyMMdd"
$outputPath = Join-Path $outputDir "extension_summary_$today.csv"
Get-ChildItem -Path $targetDir -File -Recurse |
Group-Object Extension |
Sort-Object Count -Descending |
Select-Object Name,
Count,
@{Name="TotalSizeMB"; Expression={[math]::Round(($_.Group | Measure-Object Length -Sum).Sum / 1MB, 2)}} |
Export-Csv -Path $outputPath -NoTypeInformation -Encoding UTF8
このテンプレートでは、次のような集計ができます。
.txt が何件あるか
.log が何件あるか
.csv が何件あるか
拡張子ごとの合計サイズはいくらか
共有フォルダの棚卸しや、不要ファイル調査の入口として使いやすいです。
よくあるつまずき
Select-Objectで存在しない項目を指定している
たとえば、Filename という項目は通常ありません。
Get-ChildItem -File |
Select-Object Filename
ファイル名は Name を使います。
Get-ChildItem -File |
Select-Object Name
どんな項目があるか見たい場合は、Get-Member を使います。
Get-ChildItem -File |
Get-Member
Sort-ObjectのDescendingを忘れる
サイズの大きい順にしたい場合は、-Descending が必要です。
Sort-Object Length -Descending
-Descending がないと、小さい順になります。
Group-Objectの結果をそのままCSVに出して見にくい
Group-Object の結果には、Group という詳細情報も含まれます。
そのままCSVに出すと見にくいことがあります。
Get-ChildItem -File -Recurse |
Group-Object Extension |
Export-Csv ".\summary.csv" -NoTypeInformation -Encoding UTF8
必要な項目だけ選びます。
Get-ChildItem -File -Recurse |
Group-Object Extension |
Select-Object Name, Count |
Export-Csv ".\summary.csv" -NoTypeInformation -Encoding UTF8
Lengthがバイト単位で分かりにくい
Length はバイト単位です。
MBに変換すると見やすくなります。
@{Name="SizeMB"; Expression={[math]::Round($_.Length / 1MB, 2)}}
いきなり削除処理につなげる
一覧整形に慣れると、抽出した結果を削除や移動につなげたくなります。
ただし、削除処理は必ず確認してから実行します。
Get-ChildItem -File -Recurse |
Where-Object { $_.Extension -eq ".log" } |
Remove-Item -WhatIf
まず -WhatIf で対象を確認するのがおすすめです。
まとめ
この記事では、PowerShellで一覧を整形するための Select-Object / Sort-Object / Group-Object を整理しました。
基本的な役割は次の通りです。
| コマンド | 役割 |
|---|---|
| Select-Object | 必要な項目だけ選ぶ |
| Sort-Object | 並べ替える |
| Group-Object | グループ化して件数を数える |
| Measure-Object | 合計・平均・最大・最小を出す |
実務でよく使う形は、次の通りです。
Get-ChildItem -File -Recurse |
Where-Object { 条件 } |
Sort-Object LastWriteTime -Descending |
Select-Object Name, FullName, LastWriteTime |
Export-Csv -Path ".\result.csv" -NoTypeInformation -Encoding UTF8
拡張子別に集計するなら、次の形です。
Get-ChildItem -File -Recurse |
Group-Object Extension |
Select-Object Name, Count
PowerShellで一覧を扱うときは、次の流れで考えると分かりやすいです。
集める
絞る
並べる
選ぶ
集計する
出力する
Select-Object、Sort-Object、Group-Object を使えるようになると、ファイル一覧をただ表示するだけでなく、調査資料や棚卸し資料として使える形に整えられます。