Intune 割り当てフィルターの構文

割り当てフィルターは「全デバイスに配るのを、条件付きで一部だけ除外する」ために不可欠です。 ただし構文は GUI ではなく式で、しかもプロパティによって使える演算子が違うという落とし穴があります。

基本形

([entity].[property name] [operation] [value])

実例ならこうです。

(group.device.model -eq "Surface Pro 9")
(group.device.operatingSystemVersion -ge "14.0.0")
(group.app.appVersion -startsWith "3.2")

group の後ろの device / app がエンティティで、 その次がプロパティ名です。ここを device.model と書かずに model だけ、と省略すると式として通りません。

演算子は 11 種類

演算子意味
-eq / -ne等しい / 等しくない
-gt / -ltより大きい / より小さい
-ge / -le以上 / 以下
-startsWithで始まる
-contains / -notContainsを含む / を含まない
-in / -notIn配列に含まれる / 含まれない

落とし穴:使える演算子はプロパティの型で決まる

ここが一番間違えられるところです。演算子は全プロパティで使えるわけではありません。

プロパティの型使える演算子
文字列(deviceName / model / manufacturer など) -eq -ne -startsWith -contains -notContains -in -notIn
バージョン(operatingSystemVersion) -eq -ne -gt -lt -ge -le
列挙(cpuArchitecture / deviceOwnership など) -eq -ne -in -notIn
比較演算子(-gt / -lt / -ge / -le)が文書化されているのは 実質 operatingSystemVersion だけです。 deviceName -gt "A" のようなことをやっても意味がありません。文字列で範囲を絞りたい場合は -startsWith や -in を使う方に発想を切り替えてください。

列挙値も同じです。cpuArchitecture なら amd64 / x86 / arm64 / unknown のいずれかでなければならず、"AMD64" のように大文字で書くと一致しません。

入れ子括弧と AND / OR の評価順

条件を組み合わせるとき、括弧は入れ子にできます。ただし括弧を省略したときの結合順はあなたの意図どおりとは限りません。

# 「Windows 11 かつ ARM」または「所有会社が共有」
((group.device.operatingSystemVersion -ge "10.0.22000" -and group.device.cpuArchitecture -eq "arm64")
 -or (group.device.deviceOwnership -eq "Company"))
括弧を付け忘れると -and と -or が混ざったときに想定と違うまとまりで評価され、 除外したはずのデバイスに当たった、ということが起きます。 2 つ以上の条件を組むときは、必ず括弧で明示するのが唯一の安全策です。

設計のコツ

▶ 生成・検証ツール

プロパティと演算子を選ぶだけでルール構文を生成します。 そのプロパティで使えない演算子を選んだ場合はその場で弾くので、 管理画面でエラーを出してから気づく、という回数を減らせます。入れ子ツリー編集にも対応しています。
Intune 割り当てフィルター 生成ツール

← Intune / MDM ハブ Win32 検出ルール OMA-URI / CSP の読み方

広告