PowerShellスクリプト入門|.ps1の変数・if・foreach・関数の書き方
PowerShell の手順を .ps1 ファイル(PowerShell スクリプト)にまとめると、同じ作業を何度でも実行できます。ただ、「比較に > を使ったらファイルができた」「日本語を書いたら構文エラーになった」「try/catch でエラーをつかまえられない」など、ほかの言語と違うところでつまずきがちです。この記事では、.ps1 の作り方と実行から、変数・文字列・配列・if・foreach・関数・引数・エラー処理・終了コードまでを実行結果つきで解説し、最後に古いログファイルを一覧にするスクリプトを作ります。
実行結果は Windows 11 標準の Windows PowerShell 5.1(5.1.26100)で確かめたものです(パスは C:\Users\user\ps-practice に置き換え、エラーはこの PC の表示どおり英語で載せています)。仕様は Microsoft Learn の 5.1 版ドキュメント(about_Variables・about_If・about_Foreach・about_Functions・about_Try_Catch_Finally など)で確認しました。コマンドの基本は「PowerShellの基本コマンド一覧」で解説しています。
最初のスクリプトを作って実行する
PowerShell スクリプトは、コマンドを書き並べて拡張子 .ps1 で保存したテキストファイルです。次の内容を hello.ps1 という名前で練習用フォルダーに保存します。# から行末まではコメント(メモ)で、実行されません。
# hello.ps1:最初のスクリプト
$name = "花子"
Write-Output "こんにちは、$name さん"
Write-Output "今日は $(Get-Date -Format 'yyyy-MM-dd') です"
保存するときの文字コードは「UTF-8(BOM 付き)」にしてください。日本語を含む .ps1 を BOM なしの UTF-8 で保存すると、PowerShell 5.1 では日本語が化けたり構文エラーになったりします(理由は後の「よくある間違い」で実演します)。エディターの保存時の文字コードの設定で選ぶか、後で紹介するコマンドで変換します。
保存したら、PowerShell でそのフォルダーに移動して実行します。同じフォルダーにあるスクリプトでも、名前だけでは実行できず、先頭に .\(今いるフォルダー)を付けます。これは、同じ名前のコマンドとの取り違えを防ぐための仕様です(about_Scripts)。
.\hello.ps1
「スクリプトの実行が無効」と出たら
何も設定していない Windows では、次のエラーで止められます。
.\hello.ps1 : File C:\Users\user\ps-practice\hello.ps1 cannot be loaded because running scripts is disabled on this system.
+ FullyQualifiedErrorId : UnauthorizedAccess
原因は実行ポリシーという設定で、Windows のパソコン(クライアント)の既定は、スクリプトを一切実行しない Restricted です(about_Execution_Policies)。原因と、自分のユーザーだけ設定を変える方法は「Pythonの仮想環境venvの使い方」の「PowerShell で『スクリプトの実行が無効』と出たとき」で詳しく説明しています。
パソコンの設定を変えずに練習するなら、次のどちらかを使います。どちらもその PowerShell の中だけに効きます。1 つ目は今開いている PowerShell だけで許可する方法、2 つ目は新しい PowerShell でそのスクリプトだけを実行する方法です。
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process
powershell -ExecutionPolicy Bypass -File .\hello.ps1
どちらでも次のように表示され、あとで新しく開いた PowerShell の Get-ExecutionPolicy は Restricted のままでした。
こんにちは、花子 さん
今日は 2026-10-19 です
注意:Bypass は「何もブロックせず警告もしない」設定です。中身の分かる自分のスクリプトにだけ使い、ネットで拾った .ps1 を読まずに実行しないでください(実行ポリシーはセキュリティの境界ではありません)。
変数と型
変数は $ で始まる名前で、宣言なしで $count = 3 のように代入するだけで作れます。名前の大文字・小文字は区別されず、$name と $Name は同じ変数です。まだ代入していない変数の値は $null(何もない)になります(about_Variables)。
値の種類(型)は自動で決まり、.GetType().Name で確かめられます。3 は Int32(整数)、1.5 は Double(小数)、”report” は String(文字列)、$true は Boolean(真偽値)でした。
注意したいのは、文字列と数値を足した結果が左側の型で決まることです。"10" + 5 は 105(文字列としてつなげた)、10 + "5" は 15(数値として足した)でした。ファイルから読んだ数字は文字列なので、計算に使う変数は型を決めておくと安全です。変数名の前に [int] のように型を書くと、その変数には整数しか入らなくなります。
[int]$age = "20"
$age + 1
$age = "abc"
“20” は整数に変換されて $age + 1 は 21 になりました。整数にできない “abc” を入れようとすると、次のエラーになり、$age は 20 のまま変わりませんでした。
Cannot convert value "abc" to type "System.Int32". Error: "Input string was not in a correct format."
文字列:”…” と ‘…’ の違い
PowerShell では、ダブルクォート “…” の中の変数は値に置き換わり(展開)、シングルクォート ‘…’ の中はそのままの文字になります(about_Quoting_Rules)。次のスクリプトで違いを確かめました。
$name = "花子"
$files = @("a.log", "b.log")
"1: こんにちは、$name さん"
'2: こんにちは、$name さん'
"3: ファイル数は $files.Count 個"
"4: ファイル数は $($files.Count) 個"
"5: 合計は $(1 + 2)"
"6: `$name の値は $name"
"7: ${name}様"
1: こんにちは、花子 さん
2: こんにちは、$name さん
3: ファイル数は a.log b.log.Count 個
4: ファイル数は 2 個
5: 合計は 3
6: $name の値は 花子
7: 花子様
3 行目のように、”…” の中で展開されるのは $files までで、.Count は文字のまま残ります。プロパティや計算は 4・5 行目のように $( ) で囲みます。6 行目の `(バッククォート)は PowerShell のエスケープ文字で、`$ は $ そのもの、`t はタブ、`n は改行です(\ ではありません)。変数名のすぐ後ろに文字が続くときは、7 行目のように ${name} と区切ると確実です。
配列とハッシュテーブル
配列は複数の値を順番に並べたものです。@( ) の中にカンマ区切りで書き、[0] から始まる番号で取り出します。
$fruits = @("apple", "banana", "cherry")
$fruits[0]
$fruits[-1]
$fruits.Count
$fruits += "durian"
$fruits -join ", "
結果は順に apple、cherry(-1 は最後の要素)、3、そして apple, banana, cherry, durian でした。+= で要素を追加でき、-join で 1 つの文字列にまとめられます。
ハッシュテーブルは「キーと値」の組を集めたもので、ほかの言語の辞書(dict)や連想配列にあたります。@{ } の中に キー = 値 を ; か改行で区切って書きます。
$user = @{ Name = "Hanako"; Age = 28; Dept = "Dev" }
$user.Name
$user["Age"]
$user.Email = "hanako@example.com"
$user.Count
結果は Hanako、28、4(Email を追加して 4 組)でした。値は .キー でも ["キー"] でも取り出せます。
ふつうのハッシュテーブルは、表示や繰り返しのときのキーの順番が決まっていません(about_Hash_Tables)。書いた順番を保ちたいときは [ordered]@{ Host = "localhost"; Port = 8080 } のように書きます(試すと、書いた順に取り出せました)。
if と比較演算子
$score = 72
if ($score -ge 80) {
"A"
} elseif ($score -ge 60) {
"B"
} else {
"C"
}
条件分岐は if・elseif・else で書き、結果は B でした。PowerShell の比較は == や > ではなく、-eq や -gt のような「-」で始まる演算子を使います。> はファイルへの書き出し(リダイレクト)に使われているためです。
| 演算子 | 意味 | 例と結果 |
|---|---|---|
| -eq / -ne | 等しい / 等しくない | “abc” -eq “ABC” → True |
| -gt / -ge | より大きい / 以上 | 5 -gt 3 → True |
| -lt / -le | より小さい / 以下 | 10 -le 9 → False |
| -like | ワイルドカード(* ?)で一致 | “report.LOG” -like “*.log” → True |
| -match | 正規表現で一致 | “ERROR 404 Not Found” -match “\d+” → True |
| -and / -or / -not | かつ / または / 否定 | ($size -gt 100) -and ($size -lt 1000) |
表の 1 行目のとおり、文字列の比較は大文字・小文字を区別しません。-like も同じで、”report.LOG” は “*.log” に一致しました。区別したいときは c を付けた -ceq・-clike・-cmatch を使います("abc" -ceq "ABC" は False でした)。
もう 1 つ、左側が配列だと、結果は True/False ではなく「条件に合う要素」になります。1, 2, 3, 2 -eq 2 の結果は 2 が 2 つでした(about_Comparison_Operators)。変数が空かどうかを調べるときは、この影響を受けないように $null -eq $x と $null を左に書くのが決まりです。
繰り返し:foreach と ForEach-Object の違い
配列の要素を 1 つずつ処理する方法は 2 つあります。foreach 文は「foreach (変数 in 集まり) { 処理 }」の形で、ForEach-Object はパイプ(|)で受け取った 1 件ずつを $_ で扱うコマンドレットです。
$servers = @("web01", "web02", "db01")
foreach ($s in $servers) {
"check: $s"
}
$servers | ForEach-Object { "check: $_" }
どちらも check: web01・check: web02・check: db01 と表示されます。結果は同じですが、データの流れ方が違います。次のスクリプトで、値を作る側と使う側の順番を表示させてみました。
function Get-Number {
foreach ($n in 1..3) {
Write-Host "作る $n"
$n
}
}
"--- ForEach-Object"
Get-Number | ForEach-Object { Write-Host " 使う $_" }
"--- foreach 文"
foreach ($n in Get-Number) { Write-Host " 使う $n" }
--- ForEach-Object
作る 1
使う 1
作る 2
使う 2
作る 3
使う 3
--- foreach 文
作る 1
作る 2
作る 3
使う 1
使う 2
使う 3
ForEach-Object はできた順に 1 件ずつ流れて処理され、foreach 文は先に全部そろえてから処理を始めました。使い分けの目安は次のとおりです。
目安として、変数にある配列を if や break を使って処理するなら foreach 文、Get-ChildItem などの結果をパイプでつなぐなら ForEach-Object が向いています。なお、foreach 文の中で $_ を使っても空でした。
関数と param()
関数は function 名前 { } で作り、受け取る値(パラメーター)は param( ) の中に書きます。名前は Get-Tax のように「動詞-名詞」にするのが PowerShell の決まりです(about_Functions)。スクリプトの中では、関数は呼び出す行より上で定義しておく必要があります。
function Get-Tax {
param(
[int]$Price,
[double]$Rate = 0.1
)
return [int]($Price * $Rate)
}
Get-Tax -Price 1000
Get-Tax -Price 1000 -Rate 0.08
Get-Tax 500
結果は 100、80、50 でした。$Rate = 0.1 のように書いた値は、省略したときの既定値になります。呼び出すときは、コマンドレットと同じく -Price 1000 の形で渡し、3 行目のように名前を省いて順番で渡すこともできます。
スクリプトに引数を渡す(param ブロック)
スクリプト自体にも引数を渡せます。ファイルの先頭(コメントは前にあってよい)に param ブロックを書くと、関数のパラメーターと同じように使えます。次の greet.ps1 では、[Parameter(Mandatory)] で Name を必須にしています。
param(
[Parameter(Mandatory)]
[string]$Name,
[int]$Times = 1
)
for ($i = 1; $i -le $Times; $i++) {
"[$i] こんにちは、$Name さん"
}
.\greet.ps1 -Name 太郎 -Times 2
[1] こんにちは、太郎 さん
[2] こんにちは、太郎 さん
-Times abc のように整数にできない値を渡すと、スクリプトが始まる前に「Cannot convert value “abc” to type “System.Int32″」のエラーで止まりました。必須の Name を省くと値の入力を求められ、powershell -NonInteractive -File で実行した場合は「missing mandatory parameters: Name」のエラーで終了しました。
エラー処理(try/catch・-ErrorAction Stop)
PowerShell のエラー処理で一番大事なのは、エラーには「止まるエラー(終了エラー)」と「表示だけして続くエラー(終了しないエラー)」があることです。try/catch がつかまえるのは止まるエラーだけです(about_Try_Catch_Finally)。ファイルが見つからないといった多くのコマンドレットのエラーは、表示だけして続くほうなので、そのままでは catch に来ません。
try {
Get-Item -Path .\no-such-file.txt
"続きの行も実行された"
} catch {
"catch に来た"
}
実行すると、赤い文字で「Cannot find path … because it does not exist.」と表示されたあと、続きの行も実行された と表示され、catch は実行されませんでした。catch でつかまえるには、コマンドに -ErrorAction Stop を付けて「止まるエラー」に変えます。
try {
Get-Item -Path .\no-such-file.txt -ErrorAction Stop
"この行は実行されない"
} catch {
"catch に来た: $($_.Exception.Message)"
} finally {
"finally は必ず実行される"
}
catch に来た: Cannot find path 'C:\Users\user\ps-practice\no-such-file.txt' because it does not exist.
finally は必ず実行される
catch の中では $_ に今のエラーが入り、$_.Exception.Message でメッセージを取り出せます。finally はエラーがあってもなくても最後に実行されるので、後片付けを書きます。
コマンドごとに -ErrorAction Stop を書く代わりに、スクリプトの先頭で $ErrorActionPreference = “Stop” と書くと、そのスクリプトのエラーがすべて「止まるエラー」になります。既定値は Continue(表示して続ける)です(about_Preference_Variables)。この設定で try の外でエラーが起きると、スクリプトはその場で終了しました。途中で失敗したまま次の処理(削除やコピー)に進むのを防げるので、ファイルを操作するスクリプトでは先頭に書いておくのがおすすめです。
終了コード(exit・$LASTEXITCODE)
スクリプトが成功したか失敗したかをほかのプログラム(タスクスケジューラや CI、バッチファイル)に伝えるのが終了コードです。0 が成功、0 以外が失敗を表すのが一般的で、exit 2 のように書いて返します。exit を書かないスクリプトは終了コードを返しません(about_Scripts)。次の check-file.ps1 は、ファイルがなければ 2 を返します。
param([string]$Path)
if (-not (Test-Path -Path $Path)) {
Write-Error "見つかりません: $Path"
exit 2
}
"OK: $Path"
exit 0
終了コードは、実行した直後に自動変数 $LASTEXITCODE で確かめます。
.\check-file.ps1 -Path .\nothing.txt; $LASTEXITCODE
エラーの表示のあとに 2 と表示されました。存在するファイルなら 0 でした。コマンドプロンプトから powershell -File .\check-file.ps1 -Path .\x.txt で実行したときも、%ERRORLEVEL% は 2 になりました。
$LASTEXITCODE には外部プログラム(git や python など)の終了コードも入ります(cmd /c exit 5 のあとは 5 でした)。また、powershell -File で実行したスクリプトがつかまえていないエラーで止まると、終了コードは 1 になります(about_Automatic_Variables。実際に 1 でした)。
実例:古いログファイルを一覧にするスクリプト
ここまでの内容を組み合わせて、フォルダー(サブフォルダーも含む)から指定した日数より古いログファイルを一覧にします。一覧を出すだけで、何も削除しません。Find-OldLog.ps1 という名前で UTF-8(BOM 付き)で保存します。
<#
Find-OldLog.ps1
フォルダーの中から、指定した日数より古いログファイルを一覧にする(削除はしない)
#>
param(
[Parameter(Mandatory)]
[string]$Path,
[int]$Days = 30,
[string]$Filter = "*.log"
)
$ErrorActionPreference = "Stop"
try {
$root = (Resolve-Path -Path $Path).ProviderPath
$limit = (Get-Date).AddDays(-$Days)
$oldFiles = @(
Get-ChildItem -Path $root -Filter $Filter -File -Recurse |
Where-Object { $_.LastWriteTime -lt $limit } |
Sort-Object LastWriteTime
)
if ($oldFiles.Count -eq 0) {
Write-Output "$Days 日より古い $Filter はありません"
exit 0
}
$totalKB = 0
foreach ($file in $oldFiles) {
$totalKB += $file.Length / 1KB
}
$oldFiles | Select-Object `
@{ Name = "更新日時"; Expression = { $_.LastWriteTime.ToString("yyyy-MM-dd") } },
@{ Name = "KB"; Expression = { [math]::Round($_.Length / 1KB, 1) } },
@{ Name = "ファイル"; Expression = { $_.FullName.Substring($root.Length + 1) } } |
Format-Table -AutoSize
Write-Output ("{0} 日より古いファイル:{1} 件、合計 {2:N1} KB" -f $Days, $oldFiles.Count, $totalKB)
exit 0
}
catch {
Write-Output "エラー:$($_.Exception.Message)"
exit 1
}
<# ... #> は複数行のコメント、行末の ` は「次の行に続く」、1KB は 1024 を表します。@( ) で囲んで 0 件でも .Count が使えるようにし、エラーは try/catch でつかまえて終了コード 1 で終わります。
練習用に logs フォルダーを作り、更新日時が 1〜110 日前のファイルを 6 個(.log が 5 個、.txt が 1 個。1 個は archive サブフォルダーの中)置いて実行しました。
.\Find-OldLog.ps1 -Path .\logs
更新日時 KB ファイル
---- -- ----
2026-07-01 1.5 archive\old-20260701.log
2026-08-01 2.9 app-20260801.log
2026-09-10 4.4 app-20260910.log
30 日より古いファイル:3 件、合計 8.8 KB
9 日前・1 日前の .log と、古くても .txt のファイルは表示されていません。-Days 60 を付けると 2 件、-Days 200 では「200 日より古い *.log はありません」となりました。存在しないフォルダーを指定すると「エラー:Cannot find path … because it does not exist.」と表示され、$LASTEXITCODE は 1 でした。
削除する前に -WhatIf で確かめる
一覧を見て「これを消したい」となったときも、いきなり削除せず、まず -WhatIf を付けて「何が消えるか」だけを表示させます。-WhatIf を付けた Remove-Item は、実際には何も削除しません。
Get-ChildItem -Path .\logs -Filter *.log -File -Recurse | Where-Object { $_.LastWriteTime -lt (Get-Date).AddDays(-30) } | Remove-Item -WhatIf
What if: Performing the operation "Remove File" on target "C:\Users\user\ps-practice\logs\app-20260801.log".
What if: Performing the operation "Remove File" on target "C:\Users\user\ps-practice\logs\app-20260910.log".
What if: Performing the operation "Remove File" on target "C:\Users\user\ps-practice\logs\archive\old-20260701.log".
実行後もファイルは 6 個のまま残っていました。注意:Remove-Item で消したファイルはごみ箱に入らず、元に戻せません。-WhatIf を外して本当に削除するのは、表示された一覧が正しいことを確かめ、必要ならバックアップを取ってからにしてください。-Path を間違えると、関係ないフォルダーのファイルまで対象になります。
よくある間違い・トラブル
日本語を書いたら構文エラー・文字化けになる(BOM なし UTF-8)
最初の hello.ps1 を BOM なしの UTF-8 で保存して PowerShell 5.1 で実行すると、次のエラーになりました。
At C:\Users\user\ps-practice\hello-nobom.ps1:3 char:15
+ Write-Output "縺薙s縺ォ縺。縺ッ縲・name 縺輔s"
+ ~~~~~~~~~~~~~~~
Unexpected token '縺薙s縺ォ縺。縺ッ縲・name' in expression or statement.
+ CategoryInfo : ParserError: (:) [], ParseException
Microsoft のドキュメント(about_Character_Encoding)には、BOM のない .ps1 を Windows PowerShell は古い「ANSI」の文字コード(日本語の Windows では Shift_JIS 系)として読んでしまうと書かれています。UTF-8 の日本語を Shift_JIS として読むと「縺薙s」のような文字化けになり、さらに文字の区切りがずれて閉じる側の " が前の文字に飲み込まれるため、文字列が閉じずに構文エラーになります。2 行目の "花子" で起きていました。
構文エラーにならない場合も、Write-Output "処理が完了しました" は 蜃ヲ逅・′螳御コ・@縺セ縺励◆ と化けました。直すには UTF-8(BOM 付き)で保存し直します。PowerShell 5.1 なら次の 2 行で変換できました(読むときも -Encoding UTF8 が必要です)。
$text = Get-Content -Path .\hello.ps1 -Raw -Encoding UTF8
Set-Content -Path .\hello.ps1 -Value $text -Encoding UTF8
VS Code などで作ったファイルは BOM なしの UTF-8 になり、同じドキュメントによると PowerShell 7 ではそのまま動きますが 5.1 では壊れることがあります(PowerShell 7 での動作はこの記事では試していません)。5.1 でも使うスクリプトに日本語を書くなら BOM 付きにしましょう。BOM の仕組みは「UTF-8とは?」で、化けた文字列を元に戻したいときは「文字化け復元ツール」が使えます。
比較に > を使ってファイルができた
if ($size > 10) { "big" } else { "small" } は、エラーにならずに small と表示されました。しかしフォルダーを見ると「10」という名前のファイルができていて、中身は $size の値(2)でした。> は「ファイルに書き出す」なので、比較は必ず -gt を使います。== も使えず、The term '=' is not recognized というエラーになりました。
関数の戻り値に余計なものが入る
PowerShell の関数は、return の値だけでなく、途中で出力したものすべてを返します(about_Functions)。次の関数は合計 6 だけを返すつもりでした。
function Get-Total {
param([int[]]$Numbers)
"計算します"
$sum = 0
foreach ($n in $Numbers) { $sum += $n }
return $sum
}
$t = Get-Total -Numbers 1, 2, 3
$t.Count
結果は 2 で、$t には「計算します」と 6 の 2 つが入っていました。画面に表示するだけのメッセージは Write-Host を使うと戻り値に混ざりません(Write-Host に変えると $t は 1 件になりました)。
関連する記事・ツール
- PowerShellの基本コマンド一覧|コマンドプロンプト・Linuxとの対応表と実行例
- Pythonの仮想環境venvの使い方|Windows・Linuxでの作成と有効化を解説(実行ポリシーのエラー)
- 環境変数PATHとは?Windows・Linuxの確認・設定と「認識されません」の直し方
- UTF-8とは?仕組み・バイト数・BOMの有無をわかりやすく解説
- 文字化け復元ツール:「縺薙s」のような文字化けを元に戻す
- PowerShellのパイプとWhere-Object・Select-Objectの使い方