PowerShell 実践リファレンス（AWS）｜Windows EC2運用とAWS Tools for PowerShellのユースケース

Windowsサーバーの運用に慣れた方がAWSを触るなら、PowerShellはそのまま武器になります。本記事はAWS Tools for PowerShellの導入から、Windows EC2の日常運用・S3操作・SSMでのリモート実行、AWS CLIとの使い分けまで、コピペで試せるcmdlet断片を中心にまとめた実践リファレンスです。未経験からでも「やりたいこと→cmdlet」で引けるよう、最後に逆引き早見表を用意しました。

01なぜPowerShell×AWSなのか

Windowsサーバーの運用現場では、GUIよりもPowerShellでの操作が標準になっています。AWS上で動かすWindows Serverも同じで、OSの中の操作（サービス・イベントログ・ディスク）と、AWS側の操作（EC2やS3）を同じPowerShellスクリプトの中でまとめて書けるのが最大の利点です。

AWSのAPIをPowerShellから叩くための公式ツールが AWS Tools for PowerShell です。各AWS操作が「cmdlet（コマンドレット）」として提供され、Windows標準のパイプラインやオブジェクト処理にそのまま乗せられます。

• AWSの操作を cmdlet として実行できる（例：EC2一覧、S3アップロード）
• Windows OS内の運用（サービス再起動・ログ確認）とAWS操作を1本のスクリプトに統合できる
• 戻り値が最初から.NETオブジェクトなので、テキスト整形なしでプロパティを扱える

02導入 — 必要なモジュールだけ入れる

AWS Tools for PowerShell は、サービスごとに分かれた AWS.Tools.*（モジュール式）を使うのが現在の推奨です。まずインストーラーモジュールを入れ、そこから使うサービスのモジュールだけを追加します。

# 1) インストーラーモジュールを入れる（PowerShell Gallery から）
Install-Module -Name AWS.Tools.Installer -Force

# 2) 使うサービスのモジュールだけ入れる（-CleanUp で旧バージョンを掃除）
Install-AWSToolsModule AWS.Tools.EC2,AWS.Tools.S3 -CleanUp
#   → 依存する共有モジュール AWS.Tools.Common も自動で入る

# 3) 認証プロファイルと既定リージョンをセッションに設定
Set-AWSCredential   -ProfileName my-profile     # ~/.aws/credentials のプロファイル名
Set-DefaultAWSRegion -Region ap-northeast-1     # 東京リージョンを既定に

# 4) 動作確認（S3バケット一覧が引ければ認証・リージョンはOK）
Get-S3Bucket

03基本 — cmdletの読み方とパイプライン

AWS Tools for PowerShell の cmdlet は 「動詞-AWSサービス名詞」（Verb-AWSNoun）で命名されています。取得は Get-、作成は New-、削除は Remove-、設定変更は Set- や Edit- です。まず Get- 系で「今どうなっているか」を確認するのが安全な入り方です。

• Get-Command -Module AWS.Tools.EC2 でそのサービスのcmdlet一覧を探せる
• パイプライン | でcmdletの出力を次の処理へ渡す
• Where-Object（絞り込み）/ Select-Object（列選択）/ ForEach-Object（各要素の処理）が三種の神器

# 使えるcmdletを探す（EC2モジュールの Get- 系を一覧）
Get-Command -Module AWS.Tools.EC2 -Verb Get | Select-Object Name

# パイプラインの基本：一覧 → 平坦化 → 絞り込み → 列選択
Get-EC2Instance |
  ForEach-Object { $_.Instances } |
  Where-Object   { $_.InstanceType -eq 't3.micro' } |
  Select-Object  InstanceId, InstanceType, @{n='State'; e={$_.State.Name}}

04ユースケース：インフラの確認（EC2 / S3）

日々いちばん多いのは「今どうなっているか」を確認する読み取り操作です。EC2はAPI側のフィルタで状態を絞り、S3はオブジェクトの一覧・アップロード・ダウンロードを押さえておけば大半は回ります。

# 稼働中(running)のインスタンスだけを抽出（EC2 APIのフィルタで絞る）
Get-EC2Instance -Filter @{Name='instance-state-name'; Values='running'} |
  Select-Object -ExpandProperty Instances |
  Select-Object InstanceId, InstanceType,
                @{n='Name'; e={ ($_.Tags | Where-Object Key -eq 'Name').Value }}

# S3：バケット内オブジェクトの一覧（プレフィックスで絞り込み）
Get-S3Object -BucketName my-bucket -KeyPrefix logs/2026/

# S3：アップロードとダウンロード
Write-S3Object -BucketName my-bucket -Key backup/app.zip -File .\app.zip
Read-S3Object  -BucketName my-bucket -Key backup/app.zip -File .\restore\app.zip

05ユースケース：Windows EC2の運用

ここがPowerShell×AWSの本領です。AWSのcmdletと、Windows標準のcmdletを混ぜて、OS内部の状態確認・復旧を素早く行えます。以下はすべてWindows PowerShell標準のcmdletなので、Windows EC2上でそのまま使えます。

# イベントログ（システムログの直近20件）
Get-WinEvent -LogName System -MaxEvents 20 |
  Select-Object TimeCreated, Id, LevelDisplayName, Message

# サービスの状態確認と再起動（例：IIS の W3SVC）
Get-Service    -Name W3SVC
Restart-Service -Name W3SVC

# ディスクの空き容量（GB表示に整形）
Get-Volume |
  Select-Object DriveLetter, FileSystemLabel,
                @{n='FreeGB'; e={ [math]::Round($_.SizeRemaining/1GB, 1) }}

# CPU使用の重いプロセス上位5件
Get-Process | Sort-Object CPU -Descending | Select-Object -First 5 Name, Id, CPU

06ユースケース：自動化（スクリプト / タスク / SSM）

単発の操作に慣れたら、.ps1 スクリプトにまとめて再利用します。定期実行はWindowsのタスクスケジューラ、多数のサーバへの一斉実行は SSM Run Command が便利です。

• .ps1 に処理をまとめ、引数やログ出力を付けて再利用可能にする
• タスクスケジューラ（Register-ScheduledTask）で定期実行
• 多数のインスタンスへ一斉実行するなら SSM Run Command の AWS-RunPowerShellScript
• 起動時に流したい初期化は EC2 の user-data に <powershell> ブロックで記述

# SSM Run Command でリモートのWindows EC2上のPowerShellを実行
#   （AWS.Tools.SimpleSystemsManagement モジュールが必要）
Send-SSMCommand `
  -DocumentName 'AWS-RunPowerShellScript' `
  -InstanceId   i-0123456789abcdef0 `
  -Parameter @{ commands = @('Restart-Service W3SVC', 'Get-Service W3SVC') }

# EC2 の user-data（起動時に一度だけ実行）。<powershell> タグで囲む
<powershell>
Install-WindowsFeature -Name Web-Server
</powershell>

07ユースケース：AWS CLIとの対比

同じ操作をAWS CLIとPowerShellで書き比べると、棲み分けが腑に落ちます。CLIの戻り値はJSON文字列なので、PowerShellで扱うには ConvertFrom-Json でオブジェクト化します。一方、AWS Tools for PowerShell は最初からオブジェクトを返し、-Select でSDK応答の一部だけを取り出せます。

# AWS CLI：戻り値はJSON文字列 → ConvertFrom-Json でPSオブジェクトに変換
aws ec2 describe-instances --output json |
  ConvertFrom-Json |
  Select-Object -ExpandProperty Reservations

# PowerShell：戻り値は最初からオブジェクト。-Select で応答の一部だけ返す
Get-S3Object    -BucketName my-bucket -Select '*'   # SDK応答の全体
Get-EC2Instance -Select 'Reservations'              # Reservations の中身だけ

08つまづきポイントと事故らないコツ

• スクリプトが実行できない：実行ポリシーを必要範囲だけ緩和する（Set-ExecutionPolicy -Scope CurrentUser RemoteSigned）。Bypassや全体緩和は避ける
• 起動が重い：AWS.Tools は必要なサービスモジュールだけ入れる。AWSPowerShell.NetCore は全サービス入りのモノリシックで重く、新規採用は非推奨
• 認証で詰まる：キーを直書きせず、プロファイル（Set-AWSCredential）やEC2のIAMロールを使う。鍵はGitにコミットしない
• 文字化け・改行事故：ファイル出力は文字コードを明示する（UTF-8）。CRLF/LFの差異にも注意

# 実行がブロックされる時：現在ユーザーだけに緩和（影響範囲を最小に）
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

# ファイル出力はUTF-8を明示（BOM/改行の事故を防ぐ）
Get-EC2Instance | ConvertTo-Json | Out-File -FilePath out.json -Encoding utf8

09逆引き早見表（やりたいこと → cmdlet）

迷ったらここから。「やりたいこと」から使うcmdletを引ける1画面チートシートです（プレースホルダは適宜置き換えてください）。

10よくある質問（FAQ）