Intune で「設定カタログに無い項目を叩きたい」ときに書くのが OMA-URI です。
見た目はただのパスですが、先頭の ./ を忘れると動かない、
./Device と ./User で効く相手が変わる など、
決まり事を知らないと一発で失敗します。
./ は飾りではなく必須./Device/Vendor/MSFT/Policy/Config/AreaName/SettingName
./。Device/Vendor/MSFT/... のように
./ を省くと、Intune はそれを相対パスとして解釈できず設定が通りません。Vendor/MSFT/ を含んでいることも必須条件です。ここが無いと CSP として認識されません。管理画面で「OMA-URI が無効です」系エラーが出たら、まず疑うのは ① 先頭の./、②Vendor/MSFT/の有無、③ 余分なスラッシュやスペース、の 3 点です。
./Device と ./User は「誰に効くか」OMA-URI の 2 段目はスコープです。ここを間違えると「適用は成功したが誰も影響を受けていない」になります。
| プレフィックス | スコープ | 効く相手 |
|---|---|---|
./Device/ | デバイス | デバイス構成プロファイル。ログオンしたユーザー誰でもなくマシン全体に効く |
./User/ | ユーザー | ユーザー構成プロファイル。サインインしたユーザーに効く |
./Vendor/MSFT/(先頭がこれ) | 両対応 | デバイス・ユーザーのどちらでも使える。プロファイル種別で決まる |
実務で多い事故は、ユーザー側の設定を ./Device で打ってしまう(またはその逆)パターンです。
構成プロファイルの作成画面で「デバイス用」か「ユーザー用」かを選んだ後、
その選択と OMA-URI のスコープが一致しているかを必ず見てください。
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 上の位置を特定できます。
./ かVendor/MSFT/ を含むかDevice / User)がプロファイル種別と一致しているか⑤ が一番厄介です。Getで返ってきた値の型と、Replaceで送る値の型が違っていると、 反映されたように見えて実は無視、ということが起きます。
公式の Graph ↔ Windows CSP 対応表 732 件から OMA-URI を検索・合成できます。
先頭の ./ や Vendor/MSFT の形式検証もその場で走ります。
OMA-URI / Windows CSP 検索ツール
広告