ja-JP/about_Comparison_Operators.help.txt

TOPIC
    about_Comparison_Operators

簡単な説明
    比較演算子は、値どうしを比較したり、指定したパターンに一致する値を
    見つけたりするための演算子です。(PSHelpJaJP 日本語パッチ版)

詳細な説明
    比較演算子を使うと、2 つの値が等しいか、一方が他方より大きいか、
    ある値がパターンに一致するか、コレクションに含まれるか、などを判定
    できます。

    PowerShell の比較演算子は既定で「大文字と小文字を区別しません」。
    区別したい場合は演算子名の先頭に c を付けます (例: -ceq)。
    区別しないことを明示したい場合は i を付けます (例: -ieq)。

等値演算子
    -eq 等しい
    -ne 等しくない
    -gt より大きい
    -ge 以上
    -lt より小さい
    -le 以下

    例:
        2 -eq 2 # True
        "abc" -eq "ABC" # True (既定では大小を区別しない)
        "abc" -ceq "ABC" # False (c 付きは大小を区別する)
        5 -gt 3 # True

一致演算子 (ワイルドカード / 正規表現)
    -like ワイルドカード (* ?) に一致する
    -notlike ワイルドカードに一致しない
    -match 正規表現に一致する
    -notmatch 正規表現に一致しない

    例:
        "PowerShell" -like "Power*" # True
        "abc123" -match "\d+" # True
        # -match が成功すると、$Matches 変数に一致結果が格納されます
        "user@example.com" -match "(\w+)@(\w+)"
        $Matches[1] # user

包含演算子
    -contains 左辺コレクションが右辺の値を含む
    -notcontains 含まない
    -in 左辺の値が右辺コレクションに含まれる
    -notin 含まれない

    例:
        1,2,3 -contains 2 # True
        2 -in 1,2,3 # True

型演算子
    -is 指定した型である
    -isnot 指定した型でない

    例:
        "abc" -is [string] # True
        42 -isnot [string] # True

置換演算子
    -replace 正規表現に一致した部分を置き換える

    例:
        "2026-06-17" -replace "-", "/" # 2026/06/17

注意
    比較演算子の左辺がコレクション(配列)の場合、結果は「条件を満たす
    要素だけを集めた配列」になります。

    例:
        1,2,3,4 -gt 2 # 3, 4 を返す

関連項目
    about_Operators
    about_Logical_Operators
    about_Automatic_Variables (※ $Matches について)