OMA-URI と Windows CSP の読み方

Intune で「設定カタログに無い項目を叩きたい」ときに書くのが OMA-URI です。 見た目はただのパスですが、先頭の ./ を忘れると動かない、 ./Device と ./User で効く相手が変わる など、 決まり事を知らないと一発で失敗します。

形:先頭の ./ は飾りではなく必須

./Device/Vendor/MSFT/Policy/Config/AreaName/SettingName
管理画面で「OMA-URI が無効です」系エラーが出たら、まず疑うのは ① 先頭の ./、② Vendor/MSFT/ の有無、③ 余分なスラッシュやスペース、の 3 点です。

./Device と ./User は「誰に効くか」

OMA-URI の 2 段目はスコープです。ここを間違えると「適用は成功したが誰も影響を受けていない」になります。

プレフィックススコープ効く相手
./Device/デバイス デバイス構成プロファイル。ログオンしたユーザー誰でもなくマシン全体に効く
./User/ユーザー ユーザー構成プロファイル。サインインしたユーザーに効く
./Vendor/MSFT/(先頭がこれ)両対応 デバイス・ユーザーのどちらでも使える。プロファイル種別で決まる

実務で多い事故は、ユーザー側の設定を ./Device で打ってしまう(またはその逆)パターンです。 構成プロファイルの作成画面で「デバイス用」か「ユーザー用」かを選んだ後、 その選択と OMA-URI のスコープが一致しているかを必ず見てください。

Microsoft Graph のノード名との対応

OMA-URI と、Graph API で叩く設定ノードは名前が違います。 「画面で見る名前」「OMA-URI」「Graph のリソース名」の 3 体系がある、くらいに思っておくと混乱しません。

OMA-URI : ./Device/Vendor/MSFT/Policy/Config/AdmxWindowsUpdate/BranchReadinessLevel
Graph   : deviceConfigurations / PolicySetItem (Area=AdmxWindowsUpdate, Item=BranchReadinessLevel)

対応を暗記するのは無理があるので、公式の対応表を検索するのが正解です。 このサイトのツールは 732 件の対応表を内蔵していて、 人間が読めるキーワードから OMA-URI を引いたり、逆に OMA-URI から Graph 上の位置を特定できます。

合成するときのチェックリスト

  1. 先頭が ./ か
  2. Vendor/MSFT/ を含むか
  3. スコープ(Device / User)がプロファイル種別と一致しているか
  4. Area 名と Setting 名が公式表記と一致しているか(略さない)
  5. 値の型が CSP の期待する型と合っているか(文字列 / 整数 / XML / JSON)
⑤ が一番厄介です。Get で返ってきた値の型と、Replace で送る値の型が違っていると、 反映されたように見えて実は無視、ということが起きます。

▶ 検索・合成ツール

公式の Graph ↔ Windows CSP 対応表 732 件から OMA-URI を検索・合成できます。 先頭の ./ や Vendor/MSFT の形式検証もその場で走ります。
OMA-URI / Windows CSP 検索ツール

← Intune / MDM ハブ Win32 検出ルール 割り当てフィルターの構文

広告