Intune Win32 検出ルールの書き方

Win32 アプリの展開で「インストールが完了したのに未完扱いになる」「再インストールが延々と走る」ときの原因は、 ほぼ例外なく検出ルール(Detection Rule)です。ここは Intune が「このアプリが入っているか」を判断する唯一の材料で、 管理画面から見えにくい挙動がいくつもあります。

最重要:検出ルールは「全条件 AND」

検出ルールは最低 1 個必要で、定義したすべてのルール条件を満たしたときだけ「検出成功」になります。 OR で結合されることはありません。

「MSI プロダクトコード または 実行ファイルが存在すれば入っていると見なしたい」 —— これはできません。複数ルールは必ず AND です。

そのため「MSI コード」と「バージョン」の 2 条件を組んだ瞬間、 バージョンが 1 バイトでも違えば未検出になります。実運用では、 判定材料は 1 個に絞る(MSI ならプロダクトコードだけ、など)のが安全なことが多いです。

ルール型のそれぞれ

MSI

プロダクトコード(GUID)と、必要ならプロダクトバージョンで判定します。 プロダクトコードは GUID 形式である必要があります。

{1B9C8F2A-4D3E-4A77-9C11-2F5A8E6B0D43}

ファイル / フォルダ

Path / File or folder / Detection method の 3 点セットで判定します。 64bit クライアントで 32bit 関連のパスを扱うときの関連付けに注意が必要です。

落とし穴: Path に , や " などの特殊文字を含めると正しく動きません。 プログラムファイル名にカンマが入る場合は、別の判定材料(レジストリやカスタムスクリプト)に切り替えるのが確実です。

レジストリ

キーパスは HKEY_LOCAL_MACHINE\... または HKLM\... の形で指定します。 Value name を空にすると「キーの存在」だけで検出します。

カスタム検出スクリプト(PowerShell)

組みの型で判定しきれないときの最終手段。判定条件は非常にシンプルで、 スクリプトが終了コード 0 で終わり、かつ STDOUT に文字列を出力していれば「検出成功」です。

# 検出成功の例:存在パスを stdout に出して 0 で終わる
$p = "${env:ProgramFiles}\Contoso\App\App.exe"
if (Test-Path $p) {
    Write-Output $p        # ← 出力が必須
    exit 0
}
exit 1                    # ← 非検出
よくある失敗:判定できているのに Write-Output を忘れている。 終了コード 0 でも出力が空だと検出成功になりません。逆に、エラー時にも 0 を返してしまうと常時「入っている」扱いになります。

レジストリをスクリプトで見る場合は、PowerShell のドライブ表記に変換しないと Test-Path が通りません。 HKEY_LOCAL_MACHINE\Software\Contoso なら HKLM:\Software\Contoso です。

「再提供」のタイミングを知っておく

必須(required)のアプリで未検出の場合、Intune は約 24 時間以内に再提供します。 つまり検出ルールを直しても、次回チェックインまで「まだ未完」に見える時間があります。 検証するときは Intune Management Extension のサービス再起動や再同期を併用しないと、 修正が効いたのかどうか判断できません。

作り方のおすすめ手順

  1. まず判定材料を 1 つに絞る(MSI ならプロダクトコードのみ)。
  2. 実機でその材料が本当に存在することを確認する(レジストリなら reg query、ファイルなら Test-Path)。
  3. スクリプトでやるなら、検出成功時と失敗時の両方を手元で実行して終了コードと出力を見る。
  4. 管理画面に貼る前に、下のツールで全条件を検証する。

▶ 生成・検証ツール

条件を入力するだけで、全条件 AND のカスタム検出 PowerShell を出力します。 MSI の GUID 形式、レジストリルートのマップ、ファイルパスの特殊文字もこの場で弾きます。
Intune Win32 検出ルール生成ツール

← Intune / MDM ハブ OMA-URI / CSP の読み方 割り当てフィルターの構文

広告