【完全版】PowerShell Get-Contentコマンド徹底解説｜ファイル読み取りを完全マスター

PowerShellでファイル操作を行う際、最も基本的で重要なコマンドの一つがGet-Contentです。

日常的な作業で、こんな場面に遭遇することがあります：

「ログファイルの内容を確認したい」
「設定ファイルの中身をスクリプトで読み取りたい」
「大量のデータファイルを効率的に処理したい」
「ファイルの更新をリアルタイムで監視したい」

この記事では、PowerShell初心者から中級者まで役立つ、Get-Contentの基本から高度な活用法まで、実例を交えて詳しく解説します。

Get-Contentとは？
基本的な使い方
実践的な使用例
エンコーディングの処理
1. 文字化け対策
2. BOM（Byte Order Mark）の処理
パフォーマンスの最適化
1. 大容量ファイルの効率的な処理
2. パフォーマンス比較テスト
エラー処理とベストプラクティス
1. 堅牢なファイル読み取り
2. ファイルロック対策
他のコマンドレットとの連携
1. Select-Stringとの組み合わせ
2. ConvertFrom-Csvとの組み合わせ
高度な活用例
トラブルシューティング（よくある問題と解決策）
パフォーマンス比較
1. 読み取り方法別のベンチマーク
まとめ

Get-Contentとは？

基本概念

Get-Contentは、PowerShellでファイルの内容を読み取るためのコマンドレットです。

テキストファイル、CSVファイル、ログファイルなど、様々な形式のファイルから内容を取得できます。

基本構文

Get-Content
   [-ReadCount <Int64>]
   [-TotalCount <Int64>]
   [-Tail <Int32>]
   [-Path] <String[]>
   [-Filter <String>]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-Force]
   [-Credential <PSCredential>]
   [-Delimiter <String>]
   [-Wait]
   [-Raw]
   [-Encoding <Encoding>]
   [-AsByteStream]
   [-Stream <String>]
   [<CommonParameters>]

最もシンプルな使用例：

Get-Content -Path "C:\example\sample.txt"

主要なパラメーター

パラメーター	説明	例
`-Path`	読み取るファイルのパス	`"C:\logs\app.log"`
`-TotalCount`	先頭から指定行数だけ取得	`-TotalCount 10`
`-Tail`	末尾から指定行数だけ取得	`-Tail 5`
`-Wait`	ファイル更新を監視（tail -f相当）	`-Wait`
`-Encoding`	文字エンコーディング指定	`-Encoding UTF8`
`-ReadCount`	一度に読み込む行数を制御	`-ReadCount 1000`
`-Raw`	ファイル全体を一つの文字列として取得	`-Raw`

基本的な使い方

ファイル全体の読み取り

# 基本的なファイル読み取り
Get-Content -Path "C:\example\sample.txt"

# パラメーター名を省略した短縮形
Get-Content "C:\example\sample.txt"

# 複数ファイルの同時読み取り
Get-Content "file1.txt", "file2.txt", "file3.txt"

配列として行ごとに処理

# ファイル内容を配列として取得
$lines = Get-Content "C:\example\data.txt"

# 各行を処理
foreach ($line in $lines) {
    Write-Host "処理中: $line"
}

# 行数の確認
Write-Host "総行数: $($lines.Count)"

特定の行数だけ取得

# 先頭10行のみ取得
Get-Content "C:\logs\app.log" -TotalCount 10

# 末尾5行のみ取得（PowerShell 3.0以降）
Get-Content "C:\logs\app.log" -Tail 5

# PowerShell 2.0での末尾取得
Get-Content "C:\logs\app.log" | Select-Object -Last 5

実践的な使用例

ログファイルの監視と分析

リアルタイムログ監視：

# ログファイルをリアルタイムで監視（Ctrl+Cで停止）
Get-Content "C:\logs\application.log" -Wait

# 特定のキーワードを含む行のみリアルタイム表示
Get-Content "C:\logs\application.log" -Wait | Where-Object { $_ -match "ERROR|WARNING" }

ログ分析スクリプト：

# ログ分析関数
function Analyze-LogFile {
    param(
        [string]$LogPath,
        [string]$Pattern = "ERROR|WARNING|INFO"
    )
    
    $logContent = Get-Content $LogPath
    $matches = $logContent | Where-Object { $_ -match $Pattern }
    
    # 各レベルの件数を集計
    $errorCount = ($matches | Where-Object { $_ -match "ERROR" }).Count
    $warningCount = ($matches | Where-Object { $_ -match "WARNING" }).Count
    $infoCount = ($matches | Where-Object { $_ -match "INFO" }).Count
    
    [PSCustomObject]@{
        TotalLines = $logContent.Count
        ErrorCount = $errorCount
        WarningCount = $warningCount
        InfoCount = $infoCount
        MatchedLines = $matches.Count
    }
}

# 使用例
$analysis = Analyze-LogFile -LogPath "C:\logs\app.log"
$analysis | Format-Table -AutoSize

設定ファイルの処理

INI形式ファイルの読み取り：

function Read-IniFile {
    param([string]$FilePath)
    
    $ini = @{}
    $section = ""
    
    Get-Content $FilePath | ForEach-Object {
        $line = $_.Trim()
        
        # セクション行の処理
        if ($line -match '^\[(.+)\]$') {
            $section = $matches[1]
            $ini[$section] = @{}
        }
        # キー=値ペアの処理
        elseif ($line -match '^(.+?)\s*=\s*(.+)$') {
            $key = $matches[1].Trim()
            $value = $matches[2].Trim()
            if ($section) {
                $ini[$section][$key] = $value
            }
        }
    }
    
    return $ini
}

# 使用例
$config = Read-IniFile -FilePath "C:\config\app.ini"
Write-Host "Database Server: $($config['Database']['Server'])"

JSONファイルの読み取り：

# JSONファイルの読み取り
$jsonContent = Get-Content "C:\config\settings.json" -Raw | ConvertFrom-Json

# 設定値の取得
Write-Host "API Endpoint: $($jsonContent.api.endpoint)"
Write-Host "Timeout: $($jsonContent.api.timeout)"

CSVデータの処理

# CSVファイルの手動処理
$csvLines = Get-Content "C:\data\employees.csv"
$header = $csvLines[0] -split ','
$dataLines = $csvLines[1..($csvLines.Count-1)]

foreach ($line in $dataLines) {
    $values = $line -split ','
    $employee = [PSCustomObject]@{}
    
    for ($i = 0; $i -lt $header.Count; $i++) {
        $employee | Add-Member -NotePropertyName $header[$i] -NotePropertyValue $values[$i]
    }
    
    Write-Host "従業員: $($employee.Name), 部署: $($employee.Department)"
}

# Import-Csvとの比較（推奨）
$employees = Import-Csv "C:\data\employees.csv"
$employees | ForEach-Object {
    Write-Host "従業員: $($_.Name), 部署: $($_.Department)"
}

テキストファイルの検索と抽出

# 特定の文字列を含む行を検索
function Search-InFile {
    param(
        [string]$FilePath,
        [string]$SearchPattern,
        [switch]$CaseSensitive,
        [switch]$ShowLineNumbers
    )
    
    $content = Get-Content $FilePath
    $matchingLines = @()
    
    for ($i = 0; $i -lt $content.Count; $i++) {
        $line = $content[$i]
        $match = if ($CaseSensitive) {
            $line -cmatch $SearchPattern
        } else {
            $line -imatch $SearchPattern
        }
        
        if ($match) {
            if ($ShowLineNumbers) {
                $matchingLines += "Line $($i + 1): $line"
            } else {
                $matchingLines += $line
            }
        }
    }
    
    return $matchingLines
}

# 使用例
$results = Search-InFile -FilePath "C:\logs\app.log" -SearchPattern "exception" -ShowLineNumbers
$results | ForEach-Object { Write-Host $_ -ForegroundColor Red }

エンコーディングの処理

文字化け対策

# UTF-8ファイルの読み取り
Get-Content "C:\data\utf8file.txt" -Encoding UTF8

# Shift-JISファイルの読み取り（PowerShell 5.1）
Get-Content "C:\data\sjisfile.txt" -Encoding Default

# PowerShell 7でのShift-JIS読み取り
Get-Content "C:\data\sjisfile.txt" -Encoding SJIS

# エンコーディング自動判定関数
function Get-ContentWithEncoding {
    param([string]$FilePath)
    
    $encodings = @('UTF8', 'Default', 'Unicode', 'ASCII')
    
    foreach ($encoding in $encodings) {
        try {
            $content = Get-Content $FilePath -Encoding $encoding -ErrorAction Stop
            if ($content -and $content[0] -notmatch '[\x00-\x08\x0E-\x1F\x7F]') {
                Write-Host "Detected encoding: $encoding" -ForegroundColor Green
                return $content
            }
        }
        catch {
            continue
        }
    }
    
    Write-Warning "Could not determine encoding for $FilePath"
    return $null
}

BOM（Byte Order Mark）の処理

# BOM付きUTF-8ファイルの処理
$content = Get-Content "C:\data\bomfile.txt" -Encoding UTF8

# BOMを除去する必要がある場合
$contentWithoutBom = Get-Content "C:\data\bomfile.txt" -Raw -Encoding UTF8
$contentWithoutBom = $contentWithoutBom.TrimStart([char]0xFEFF)

パフォーマンスの最適化

大容量ファイルの効率的な処理

# 大容量ファイルを一度に全て読み込む（メモリ使用量大）
$content = Get-Content "C:\data\largefile.txt"

# ReadCountを使用した分割読み込み
Get-Content "C:\data\largefile.txt" -ReadCount 1000 | ForEach-Object {
    # 1000行ずつ処理
    foreach ($line in $_) {
        # 各行の処理
    }
}

# ストリーミング処理（メモリ効率が良い）
Get-Content "C:\data\largefile.txt" -ReadCount 1 | ForEach-Object {
    # 1行ずつ処理（メモリ使用量最小）
    Process-Line $_
}

パフォーマンス比較テスト

# 異なる読み取り方法のパフォーマンス測定
function Test-ReadPerformance {
    param([string]$FilePath)
    
    # 方法1: 全行一括読み込み
    $time1 = Measure-Command {
        $content = Get-Content $FilePath
        $lineCount = $content.Count
    }
    
    # 方法2: ReadCount使用
    $time2 = Measure-Command {
        $lineCount = 0
        Get-Content $FilePath -ReadCount 1000 | ForEach-Object {
            $lineCount += $_.Count
        }
    }
    
    # 方法3: ストリーミング
    $time3 = Measure-Command {
        $lineCount = 0
        Get-Content $FilePath | ForEach-Object { $lineCount++ }
    }
    
    [PSCustomObject]@{
        Method = @('Bulk Read', 'ReadCount', 'Streaming')
        Time = @($time1.TotalSeconds, $time2.TotalSeconds, $time3.TotalSeconds)
        LineCount = $lineCount
    }
}

エラー処理とベストプラクティス

堅牢なファイル読み取り

function Get-ContentSafely {
    param(
        [string]$Path,
        [string]$Encoding = 'UTF8',
        [int]$MaxRetries = 3
    )
    
    for ($i = 0; $i -lt $MaxRetries; $i++) {
        try {
            if (-not (Test-Path $Path)) {
                throw "File not found: $Path"
            }
            
            $content = Get-Content -Path $Path -Encoding $Encoding -ErrorAction Stop
            return $content
        }
        catch [System.IO.FileNotFoundException] {
            Write-Error "File not found: $Path"
            return $null
        }
        catch [System.UnauthorizedAccessException] {
            Write-Error "Access denied: $Path"
            return $null
        }
        catch [System.IO.IOException] {
            if ($i -eq ($MaxRetries - 1)) {
                Write-Error "IO Error after $MaxRetries attempts: $($_.Exception.Message)"
                return $null
            }
            Write-Warning "IO Error (attempt $($i + 1)): $($_.Exception.Message). Retrying..."
            Start-Sleep -Seconds 1
        }
        catch {
            Write-Error "Unexpected error: $($_.Exception.Message)"
            return $null
        }
    }
}

# 使用例
$content = Get-ContentSafely -Path "C:\logs\app.log"
if ($content) {
    Write-Host "Successfully read $($content.Count) lines"
}

ファイルロック対策

# ファイルがロックされている場合の対処
function Get-ContentWithRetry {
    param(
        [string]$Path,
        [int]$RetryCount = 5,
        [int]$RetryDelaySeconds = 2
    )
    
    for ($i = 0; $i -lt $RetryCount; $i++) {
        try {
            return Get-Content $Path -ErrorAction Stop
        }
        catch {
            if ($i -eq ($RetryCount - 1)) {
                throw "Failed to read file after $RetryCount attempts: $($_.Exception.Message)"
            }
            Write-Warning "File may be locked, retrying in $RetryDelaySeconds seconds..."
            Start-Sleep -Seconds $RetryDelaySeconds
        }
    }
}

他のコマンドレットとの連携

Select-Stringとの組み合わせ

# 複数ファイルから特定のパターンを検索
Get-ChildItem "C:\logs\*.log" | ForEach-Object {
    $matches = Get-Content $_.FullName | Select-String "ERROR|EXCEPTION"
    if ($matches) {
        Write-Host "=== $($_.Name) ===" -ForegroundColor Yellow
        $matches | ForEach-Object {
            Write-Host "Line $($_.LineNumber): $($_.Line)" -ForegroundColor Red
        }
    }
}

# より効率的な方法
Select-String -Path "C:\logs\*.log" -Pattern "ERROR|EXCEPTION" | 
    Group-Object Filename | 
    ForEach-Object {
        Write-Host "=== $($_.Name) ===" -ForegroundColor Yellow
        $_.Group | ForEach-Object {
            Write-Host "Line $($_.LineNumber): $($_.Line)" -ForegroundColor Red
        }
    }

ConvertFrom-Csvとの組み合わせ

# CSV形式のデータを直接処理
$csvContent = Get-Content "data.csv" -Raw
$data = $csvContent | ConvertFrom-Csv

# より効率的（推奨）
$data = Import-Csv "data.csv"

# カスタム区切り文字の処理
$tsvContent = Get-Content "data.tsv" -Raw
$data = $tsvContent | ConvertFrom-Csv -Delimiter "`t"

高度な活用例

ログローテーション対応の監視

# ログローテーションに対応したリアルタイム監視
function Watch-RotatingLog {
    param(
        [string]$LogPattern,
        [string]$SearchPattern = ".*"
    )
    
    $currentFile = $null
    $lastPosition = 0
    
    while ($true) {
        $latestFile = Get-ChildItem $LogPattern | Sort-Object LastWriteTime | Select-Object -Last 1
        
        if ($latestFile.FullName -ne $currentFile) {
            Write-Host "Switching to new log file: $($latestFile.Name)" -ForegroundColor Green
            $currentFile = $latestFile.FullName
            $lastPosition = 0
        }
        
        $content = Get-Content $currentFile
        if ($content.Count -gt $lastPosition) {
            $newLines = $content[$lastPosition..($content.Count-1)]
            $matchingLines = $newLines | Where-Object { $_ -match $SearchPattern }
            
            foreach ($line in $matchingLines) {
                Write-Host "$(Get-Date -Format 'HH:mm:ss'): $line"
            }
            
            $lastPosition = $content.Count
        }
        
        Start-Sleep -Seconds 1
    }
}

# 使用例
Watch-RotatingLog -LogPattern "C:\logs\app*.log" -SearchPattern "ERROR|WARNING"

複数ファイルの統合処理

# 複数のログファイルを時系列で統合
function Merge-LogFiles {
    param(
        [string[]]$FilePaths,
        [string]$OutputPath,
        [string]$TimestampPattern = '^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}'
    )
    
    $allLines = @()
    
    foreach ($file in $FilePaths) {
        $content = Get-Content $file
        foreach ($line in $content) {
            if ($line -match $TimestampPattern) {
                $timestamp = [DateTime]::ParseExact($matches[0], 'yyyy-MM-dd HH:mm:ss', $null)
                $allLines += [PSCustomObject]@{
                    Timestamp = $timestamp
                    Line = $line
                    Source = (Split-Path $file -Leaf)
                }
            }
        }
    }
    
    # 時系列でソート
    $sortedLines = $allLines | Sort-Object Timestamp
    
    # ファイルに出力
    $sortedLines | ForEach-Object { 
        "[$($_.Source)] $($_.Line)" 
    } | Out-File $OutputPath -Encoding UTF8
    
    Write-Host "Merged $($sortedLines.Count) log entries to $OutputPath"
}

3. 設定ファイルのバリデーション

# 設定ファイルの構文チェック
function Test-ConfigFile {
    param(
        [string]$ConfigPath,
        [hashtable]$RequiredKeys
    )
    
    try {
        $content = Get-Content $ConfigPath -Raw
        $config = $content | ConvertFrom-Json
        $errors = @()
        
        foreach ($section in $RequiredKeys.Keys) {
            if (-not $config.$section) {
                $errors += "Missing section: $section"
                continue
            }
            
            foreach ($key in $RequiredKeys[$section]) {
                if (-not $config.$section.$key) {
                    $errors += "Missing key: $section.$key"
                }
            }
        }
        
        return [PSCustomObject]@{
            IsValid = ($errors.Count -eq 0)
            Errors = $errors
            Config = $config
        }
    }
    catch {
        return [PSCustomObject]@{
            IsValid = $false
            Errors = @("Invalid JSON format: $($_.Exception.Message)")
            Config = $null
        }
    }
}

# 使用例
$requiredKeys = @{
    'database' = @('server', 'port', 'username')
    'api' = @('endpoint', 'timeout')
}

$validation = Test-ConfigFile -ConfigPath "C:\config\app.json" -RequiredKeys $requiredKeys
if (-not $validation.IsValid) {
    Write-Host "Configuration errors found:" -ForegroundColor Red
    $validation.Errors | ForEach-Object { Write-Host "  - $_" -ForegroundColor Red }
}

トラブルシューティング（よくある問題と解決策）

文字化けが発生する

# 問題のあるコード
$content = Get-Content "sjis_file.txt"

# 解決策: エンコーディングを明示的に指定
$content = Get-Content "sjis_file.txt" -Encoding Default  # PowerShell 5.1
$content = Get-Content "sjis_file.txt" -Encoding SJIS     # PowerShell 7+

大きなファイルでメモリ不足

# 問題のあるコード（大容量ファイルを一度に読み込み）
$content = Get-Content "huge_file.txt"

# 解決策1: ReadCountを使用
Get-Content "huge_file.txt" -ReadCount 1000 | ForEach-Object {
    # バッチ処理
}

# 解決策2: ストリーミング処理
Get-Content "huge_file.txt" | ForEach-Object {
    # 1行ずつ処理
}

パスの指定ミス

# 問題のあるコード
Get-Content C:\Program Files\app\config.txt

# 解決策: パスを引用符で囲む
Get-Content "C:\Program Files\app\config.txt"

# または相対パスを使用
Set-Location "C:\Program Files\app"
Get-Content "config.txt"

ファイルが存在しない場合のエラー

# エラーハンドリング付きの読み取り
if (Test-Path $filePath) {
    $content = Get-Content $filePath
} else {
    Write-Error "File not found: $filePath"
}

# Try-Catchを使用
try {
    $content = Get-Content $filePath -ErrorAction Stop
}
catch {
    Write-Error "Error reading file: $($_.Exception.Message)"
}

パフォーマンス比較

読み取り方法別のベンチマーク

# ベンチマークテスト関数
function Compare-ReadMethods {
    param([string]$TestFile)
    
    # テストファイルの作成（1万行）
    if (-not (Test-Path $TestFile)) {
        1..10000 | ForEach-Object { "Test line $_" } | Out-File $TestFile
    }
    
    $results = @()
    
    # 方法1: 一括読み込み
    $time = Measure-Command {
        $content = Get-Content $TestFile
        $lineCount = $content.Count
    }
    $results += [PSCustomObject]@{
        Method = "Bulk Read"
        Time = $time.TotalMilliseconds
        Memory = "High"
    }
    
    # 方法2: ReadCount使用
    $time = Measure-Command {
        $lineCount = 0
        Get-Content $TestFile -ReadCount 100 | ForEach-Object {
            $lineCount += $_.Count
        }
    }
    $results += [PSCustomObject]@{
        Method = "ReadCount 100"
        Time = $time.TotalMilliseconds
        Memory = "Medium"
    }
    
    # 方法3: ストリーミング
    $time = Measure-Command {
        $lineCount = 0
        Get-Content $TestFile | ForEach-Object { $lineCount++ }
    }
    $results += [PSCustomObject]@{
        Method = "Streaming"
        Time = $time.TotalMilliseconds
        Memory = "Low"
    }
    
    return $results | Sort-Object Time
}

# テスト実行
$results = Compare-ReadMethods -TestFile "C:\temp\test.txt"
$results | Format-Table -AutoSize

まとめ

PowerShellのGet-Contentコマンドレットは、ファイル読み取りの基本でありながら、非常に多機能で強力なツールです。

基本機能：

テキストファイルの読み取りと行単位の処理
特定行数の取得（先頭・末尾）
リアルタイムファイル監視
複数ファイルの同時処理

実践的な活用：

ログファイルの分析と監視
設定ファイルの読み取りと処理
データファイルの効率的な処理
文字列検索と抽出

重要なポイント：

エンコーディングの適切な指定
大容量ファイルのメモリ効率的な処理
エラーハンドリングの実装
パフォーマンスの最適化