PowerShell Windows パターン

Windows PowerShell の重要なパターンと落とし穴。

---

1. 演算子の構文ルール

重大: 括弧が必須

❌ 誤り	✅ 正解
if (Test-Path "a" -or Test-Path "b")	if ((Test-Path "a") -or (Test-Path "b"))
if (Get-Item $x -and $y -eq 5)	if ((Get-Item $x) -and ($y -eq 5))

ルール: 論理演算子を使用するときは、各 cmdlet 呼び出しを括弧で囲む必須です。

---

2. Unicode/絵文字の制限

重大: スクリプトに Unicode を使用しない

用途	❌ 使用しない	✅ 使用する
成功	✅ ✓	[OK] [+]
エラー	❌ ✗ 🔴	[!] [X]
警告	⚠️ 🟡	[*] [WARN]
情報	ℹ️ 🔵	[i] [INFO]
進捗	⏳	[...]

ルール: PowerShell スクリプトでは ASCII 文字のみを使用します。

---

3. Null チェックパターン

アクセス前に常にチェック

❌ 誤り	✅ 正解
$array.Count -gt 0	$array -and $array.Count -gt 0
$text.Length	if ($text) { $text.Length }

---

4. 文字列補間

複雑な式

❌ 誤り	✅ 正解
"Value: $($obj.prop.sub)"	まず変数に格納

パターン:

$value = $obj.prop.sub
Write-Output "Value: $value"

---

5. エラーハンドリング

ErrorActionPreference

値	用途
Stop	開発環境 (早期失敗)
Continue	本番スクリプト
SilentlyContinue	エラーが予想される場合

Try/Catch パターン

• try ブロック内で return しない
• クリーンアップには finally を使用
• try/catch の後に return する

---

6. ファイルパス

Windows パスルール

パターン	用途
リテラルパス	C:\Users\User\file.txt
変数パス	Join-Path $env:USERPROFILE "file.txt"
相対パス	Join-Path $ScriptDir "data"

ルール: クロスプラットフォーム対応のために Join-Path を使用します。

---

7. 配列操作

正しいパターン

操作	構文
空の配列	$array = @()
アイテムを追加	$array += $item
ArrayList に追加	`$list.Add($item)

---

8. JSON 操作

重大: Depth パラメータ

❌ 誤り	✅ 正解
ConvertTo-Json	ConvertTo-Json -Depth 10

ルール: ネストされたオブジェクトには必ず -Depth を指定します。

ファイル操作

操作	パターン
読み込み	`Get-Content "file.json" -Raw
書き込み	`$data

---

9. 一般的なエラー

エラーメッセージ	原因	修正
"parameter 'or'"	括弧がない	cmdlet を () で囲む
"Unexpected token"	Unicode 文字	ASCII のみを使用
"Cannot find property"	Null オブジェクト	最初に null をチェック
"Cannot convert"	型の不一致	.ToString() を使用

---

10. スクリプトテンプレート

# Strict mode
Set-StrictMode -Version Latest
$ErrorActionPreference = "Continue"

# Paths
$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path

# Main
try {
    # Logic here
    Write-Output "[OK] Done"
    exit 0
}
catch {
    Write-Warning "Error: $_"
    exit 1
}

---

覚えておいてください: PowerShell には独特の構文ルールがあります。括弧、ASCII のみの使用、null チェックは譲歩できません。

使用する場合

このスキルは、上記の概要で説明されているワークフローまたはアクションを実行する場合に適用されます。

制限事項

• このスキルは、タスクが上記で説明されたスコープと明確に一致する場合にのみ使用してください。
• 出力を環境固有の検証、テスト、または専門家レビューの代替と見なさないでください。
• 必要な入力、権限、安全境界、または成功基準が不足している場合は、停止して明確化を求めてください。