Jamf Concepts
ガイド

ガイド

Jamf Device Checker

~8 min read
この記事は役に立ちましたか?

Jamf Device Checker を使う理由

課題

エンドユーザーは、生産性に影響するデバイスの問題に頻繁に直面しますが、その特定や解決方法が分からないことがよくあります。

  • アプリのバージョンが不足している、または古い
  • iOS のバージョンが古い
  • バッテリーの状態が低下し、予期しないシャットダウンが発生する
  • ストレージ容量の問題でアプリのインストールができない
  • ネットワーク接続の問題で生産性に影響が出る
  • デバイスの過熱によるパフォーマンスのスロットリング
  • メモリ/CPU の高使用率による作業速度の低下

これらの問題は通常、ヘルプデスクへの問い合わせ、生産性の低下、ユーザーの不満につながります。

ソリューション

Jamf Device Checker は、シンプルな色分けインターフェイスを通じて、エンドユーザーがデバイスの準備状態に関する問題を自己診断・解決できるようにします。

  • = デバイスは作業可能な状態です
  • ⚠️ = 早めに対処すべき警告です
  • 🔴 = 生産性を妨げる重大な問題です

主なメリット

エンドユーザー向け: セルフサービスによるデバイス準備状態のチェック、問題を解決するための明確で実行可能なガイダンス、IT サポートの待ち時間の短縮、期限前のプロアクティブな通知。

IT チーム向け: ヘルプデスクへの問い合わせの削減、企業ポリシー(OS バージョン、必須アプリ)に基づくコンプライアンスの適用、デバイスの状態のリアルタイムな可視性、しきい値と監視ルールの構成。

組織向け: エンドユーザーの生産性向上、より優れたデバイスのライフサイクル管理、IT サポートコストの削減、コンプライアンスのトラッキングとレポート。

全体ステータス表示

このアプリは、メイン画面の上部に大きな色分けされたステータスインジケーターを表示し、デバイスの全体的な準備状態を要約します。

ステータス アイコン 説明
Ready 🟢 緑 チェックマーク 有効なすべてのチェックに合格。デバイスはすべての要件を満たしています。
Deadline Approaching 🟠 オレンジ 警告の三角形 期限が設定されたアップデートが利用可能です。「X update(s) available - Y day(s) remain」と最も早い期限までのカウントダウンを表示します。
Action Needed 🟠 オレンジ 警告の三角形 アップデートは利用可能ですが、期限は設定されていません。「X update(s) available」と表示します。
Not Ready 🔴 赤 X マーク 1 つ以上のアップデートが必要で、期限を過ぎています。「X update(s) required」と表示します。
Installing Updates 🔵 青 回転する矢印 MDM コマンドが進行中です。自動更新のための 2 分間のカウントダウンタイマーを表示します。
Off Duty ⚪ グレー Z 付きの月 Jamf Setup EA を介してデバイスが off duty としてマークされています。
Unknown ⚪ グレー 疑問符 最初のチェックが完了する前の初期状態です。

クイックスタート

前提条件

  • Jamf Pro サーバー (JPS)
  • Jamf Pro への管理者アクセス
  • Jamf Self Service アプリ(アプリインストール機能に必要)
  • ウィザード権限を持つローカルユーザーアカウント(後述)

必要な API 権限

このアプリは 2 つの異なる権限セットを使用します。

ウィザードのセットアップ用(ローカルユーザーアカウント — 初期構成時に使用):

Jamf Pro で、以下の 8 つの権限を持つローカルユーザーを作成します。

API 統合のセットアップ(一度限りのウィザード構成):

  • Read API Integrations
  • Create API Integrations
  • Update API Integrations
  • Read API Roles
  • Create API Roles
  • Update API Roles

App Config の管理(ウィザード + 継続的なアップデート):

  • Read Mobile Device Applications
  • Update Mobile Device Applications

このユーザーアカウントは、Basic Auth を介してウィザードを認証し、API 統合の作成、ロールの構成、ネイティブアプリのリンク、App Config XML の保存を行います。初期セットアップ後、このユーザーは App Config の更新にのみ必要です(Mobile Device Applications の 2 つの権限のみが必要)。

ランタイム操作用(OAuth API クライアント — ウィザードによって自動的に構成されます):

ウィザードは、リンクされたアプリ統合に割り当てられた以下の 4 つの権限を持つ「Jamf Device Checker」API ロールを自動的に作成します。

  • Send Device Information Command
  • View MDM command information in Jamf Pro API
  • Read Mobile Devices
  • Send MDM command information in Jamf Pro API

これらの権限により、Device Checker は OAuth 認証を使用して通常の操作中にデバイスの詳細を取得し、MDM コマンドを送信できます。エンドユーザーがこれらの認証情報を目にしたり使用したりすることはありません。

5 分間のセットアップ

ステップ 1: アプリを Jamf Pro に購入・追加する

  • 「Jamf Device Checker」を購入し、AxM で Jamf Pro インスタンスに割り当てます
  • Jamf Pro で Mobile Device Apps に移動します
  • Apps Purchased in Volume から「Jamf Device Checker」を追加します

ステップ 2: セットアップウィザードを実行する

  • 管理者用デバイスにアプリをインストールします
  • アプリを起動し、円形のステータス画像を長押しして Wizard モードを有効にします
  • ローカルユーザーで認証します(8 つのウィザード権限が必要 — 上記の必要な API 権限を参照)
  • ウィザードに従って以下を実行します:
    • 必要な権限を持つ API ロールを構成する
    • API 統合を作成する
    • 認証のためにネイティブアプリを API 統合にリンクする
    • マネージド App Config を生成し、JPS に保存する

ステップ 3 はありません — エンドユーザーのデバイスにスコープを設定するだけです。


完全なセットアップ手順

ステップ 1: Mobile Device App を Jamf Pro に追加する

  • 「Jamf Device Checker」を購入し、AxM で Jamf Pro インスタンスに割り当てます
  • Jamf Pro にログインします
  • Devices > Mobile Device Apps に移動します
  • + New をクリックします
  • Apps Purchased in Volume で 「Jamf Device Checker」 を検索します
  • Add をクリックして、アプリレコードを Jamf Pro インスタンスに追加します

ステップ 2: セットアップウィザードを実行する

ウィザードは、すべての認証とマネージド App 構成を自動的に処理します。

管理者用デバイスにアプリをインストールする

  • テスト用の iOS デバイスにアプリを割り当てます
  • Jamf Device Checker を起動します

Wizard モードを有効にする

  • more タブで、アプリアイコンを 3 秒間長押しします
  • Wizard Setup を選択します
  • 前提条件で作成したローカルユーザーの認証情報で認証します(8 つのウィザード権限が必要)

ウィザードのステップを完了する

API ロール

  • ウィザードは既存の「Jamf Device Checker」API ロールを確認します
  • 見つからない場合、必要な権限を持つロールを作成します:
    • Send Device Information Command
    • View MDM command information in Jamf Pro API
    • Read Mobile Devices
    • Send MDM command information in Jamf Pro API
  • ロールを API 統合にリンクします

ネイティブアプリの認証

  • ウィザードは、モバイルデバイスアプリのレコードを API 統合にリンクします
  • Managed App Config を介した OAuth 認可コードの配信を有効にします

App Config の生成

  • ウィザードは完全な Managed App Config を生成します
  • Jamf Pro に送信します

ステップ 3: デバイスへのスコープ設定

  • 同じアプリレコードで Scope をクリックします
  • 対象のデバイスグループ、スマートグループ、または個々のデバイスを追加します
  • Save をクリックします

構成リファレンス

このアプリは、すべて Jamf Pro の Managed App Config を通じて構成されます。以下は、利用可能なすべてのキーの完全なリファレンスです。

必須キー

これらのキーは Jamf Pro によって自動的に設定されます — 変更または削除しないでください

キー 説明
JPS_URL Jamf Pro サーバー URL(自動設定: $JPS_URL
JSSID デバイスの JSS ID(自動設定: $JSSID
MANAGEMENTID デバイスの Management ID(自動設定: $MANAGEMENTID
OAUTH_AUTH_CODE OAuth 認可コード(自動設定: $OAUTH_AUTH_CODE
APP_CONFIG_REINSTALL_CODE 再インストールトリガーコード(自動設定: $APP_CONFIG_REINSTALL_CODE
APPJSSID Jamf Device Checker アプリレコード ID(自動設定: $APPJSSID

ブランディングとアラート URL

キー デフォルト 説明
device-checker-branding-image-url String (空) 会社ロゴ画像(PNG/JPG)への URL。ブランディングが不要な場合は空欄にします。
device-checker-branding-image-height Integer 80 ロゴの高さ(ポイント単位)。
device-checker-alerts-url String (空) アラート/ステータスページの任意の URL。Alerts タブにリンクを表示します。

例:

<key>device-checker-branding-image-url</key>
<string>https://yourcompany.com/logo.png</string>
<key>device-checker-branding-image-height</key>
<string>60</string>

共有ボタン

More タブでのステータス共有とログエクスポート機能の表示を制御します。

キー デフォルト 説明
device-checker-send-status-enabled String YES 「Send Status」ボタンを表示(メール/メッセージでデバイスの準備状態のサマリーを共有)
device-checker-send-logs-enabled String YES 「Send Logs」ボタンを表示(トラブルシューティング用にアプリログをエクスポート)

例:

<key>device-checker-send-status-enabled</key>
<string>YES</string>
<key>device-checker-send-logs-enabled</key>
<string>NO</string>

UI の動作

Status タブのスクロール動作を制御します。

キー デフォルト 説明
device-checker-status-tab-scrollable String NO YES の場合、Status タブ全体(ヘッダー + 全体ステータス + タイル)をスクロール可能にします。NO(デフォルト)の場合、ヘッダーと全体ステータスは固定され、下のタイルのみがスクロールします。

例:

<key>device-checker-status-tab-scrollable</key>
<string>NO</string>

有効にするタイミング: ほとんどのデプロイメントではデフォルト(NO)が最適です — タイルをスクロールしている間、ヘッダーと全体的な準備状態が表示され続けます。ビュー全体を一緒にスクロールする必要がある場合や、小型デバイスで長めのブランディングヘッダーに対応する場合は YES に設定します。


オペレーティングシステムの準備状態

構成可能な最小バージョンと期限を使用して、OS バージョン要件を監視します。

キー デフォルト 説明
device-checker-os-enabled String YES OS バージョン監視タイルを有効化
device-checker-os-min-version String (なし) 必要な最小 OS バージョン(例: 26.2
device-checker-os-deadline String (なし) YYYY-MM-DD 形式の要件期限

例:

<key>device-checker-os-enabled</key>
<string>YES</string>
<key>device-checker-os-min-version</key>
<string>26.2</string>
<key>device-checker-os-deadline</key>
<string>2026-06-30</string>

ステータスロジック:

緑 (Ready) — 現在の OS バージョンが最小要件を満たしています

⚠️ 黄 (Warning) — 現在の OS バージョンが最小値を下回っていますが、期限は過ぎていません(または期限が設定されていません)

🔴 赤 (Not Ready) — 現在の OS バージョンが最小値を下回っており、かつ期限を過ぎています


アプリの準備状態

必須のマネージドアプリのインストール状況とバージョン要件を監視します。

キー デフォルト 説明
device-checker-apps-enabled String NO アプリ監視タイルを有効化
device-checker-apps-list String (空) パイプ区切りのアプリのリスト(下記の形式を参照)

アプリリストの形式:

AppName,bundleID,minVersion,deadline|AppName2,bundleID2,minVersion2,deadline2|...

例:

<key>device-checker-apps-enabled</key>
<string>YES</string>
<key>device-checker-apps-list</key>
<string>Slack,com.tinyspeck.chatlyio,24.0.0,2026-03-01|Microsoft Teams,com.microsoft.skype.teams,5.0.0,2026-06-01</string>

ステータスロジック:

緑 (Ready) — すべてのアプリがインストール済みで、最小バージョンを満たしています

⚠️ 黄 (Warning) — 1 つ以上のアプリが更新を必要としていますが、期限は過ぎていません

🔴 赤 (Not Ready) — 1 つ以上のアプリが更新を必要としており、かつ期限を過ぎています

Pending — アプリのインストールが進行中です(下記の Self Service 統合を参照)

Self Service 統合:

アプリが不足しているか古い場合、ユーザーは Apps タイルの 「Update Apps」 ボタンをタップして、必要なアプリを自動的にインストールまたは更新できます。ワークフローは次のとおりです。

  1. ユーザーが Apps タイルの「Update Apps」ボタンをタップします
  2. Jamf Self Service アプリが自動的に開き、不足/古いアプリがキューに入ります
  3. Device Checker が「Pending」ステータスに入り、2 分間の自動更新タイマーを開始します
  4. アプリは 2 分ごとに自動的に更新し、インストールが完了したかどうかを確認します
  5. すべてのアプリが要件を満たすと、ステータスは緑に戻ります

要件: Jamf Self Service がデバイスにインストールされている必要があり、アプリが Self Service で利用可能でデバイスにスコープ設定されている必要があります。また、アプリは Jamf Pro で「Display app in Self Service after it is installed」がチェックされている必要があります。

注意点:

  • Bundle ID は正確に一致する必要があります(大文字と小文字を区別)
  • バージョン比較にはセマンティックバージョニングを使用します(例: 2.5.0 > 2.4.9
  • 期限は任意です(不要な場合は空欄にします: AppName,bundleID,minVersion,

電源(バッテリーレベル)

構成可能な警告および重大しきい値でバッテリーの充電レベルを監視します。

キー デフォルト 説明
device-checker-power-source-enabled String YES バッテリーレベル監視タイルを有効化
device-checker-power-source-warning Integer 25 警告しきい値(パーセンテージ)
device-checker-power-source-critical Integer 10 重大しきい値(パーセンテージ)

例:

<key>device-checker-power-source-enabled</key>
<string>YES</string>
<key>device-checker-power-source-warning</key>
<string>25</string>
<key>device-checker-power-source-critical</key>
<string>10</string>

ステータスロジック:

🔴 赤 (Critical) — バッテリーが重大しきい値以下

⚠️ 黄 (Warning) — バッテリーが警告しきい値以下(ただし重大しきい値超)

緑 (Ready) — バッテリーが警告しきい値超

充電中 — デバイスが電源に接続されています(充電中は常に緑)


ストレージ容量

構成可能な警告および重大しきい値(使用率に基づく)で利用可能なストレージを監視します。

キー デフォルト 説明
device-checker-storage-enabled String YES ストレージ監視タイルを有効化
device-checker-storage-warning Integer 75 警告しきい値(使用率 %)
device-checker-storage-critical Integer 90 重大しきい値(使用率 %)

例:

<key>device-checker-storage-enabled</key>
<string>YES</string>
<key>device-checker-storage-warning</key>
<string>75</string>
<key>device-checker-storage-critical</key>
<string>90</string>

ステータスロジック:

🔴 赤 (Critical) — ストレージ使用率が重大しきい値以上

⚠️ 黄 (Warning) — ストレージ使用率が警告しきい値以上(ただし重大しきい値未満)

緑 (Ready) — ストレージ使用率が警告しきい値未満


バッテリーの状態

バッテリーの状態を監視し、バッテリー交換が必要になる可能性のあるデバイスを特定します。このタイルは、バッテリーの状態と現在の充電パーセンテージを表示します。

キー デフォルト 説明
device-checker-battery-enabled String YES バッテリー状態監視タイルを有効化

例:

<key>device-checker-battery-enabled</key>
<string>YES</string>

ステータスロジック:

緑 (Ready) — バッテリーの状態が「Normal」または「Unsupported」

🔴 赤 (Not Ready) — バッテリーの状態が「Service-Recommended」または「Non-Genuine」

グレー (Unknown) — バッテリーの状態が「Unknown」、またはバッテリーデータを取得できない

状態の値:

  • Normal — バッテリーは正常に機能しています(緑)
  • Service-Recommended — バッテリー容量が低下しており、交換を推奨します(赤)
  • Non-Genuine — Apple 製以外のバッテリーが検出されました。交換を推奨します(赤)
  • Unsupported — このデバイスモデルではバッテリー状態の監視が利用できません(緑、充電 % のみ表示)
  • Unknown — iOS からの状態データがまだ利用できません(グレー、充電 % のみ表示)

タイル表示: ステータスの色とアイコンはバッテリーの状態に基づきます。サブタイトルには、問題がある場合はバッテリー状態の問題が表示され、そうでない場合は現在の充電パーセンテージが表示されます。詳細ビューには、充電レベル、充電状態、低電力モード、バッテリーの状態、および推奨事項が表示されます。

注意点:

  • バッテリーの状態データは Declarative Device Management (DDM) から取得されます
  • 新しいデバイスでは、iOS が状態メトリクスを計算するまで「Unknown」と表示される場合があります(通常は数回の充電サイクル後)
  • 充電パーセンテージは常にサブタイトルまたは詳細ビューに表示されます
  • このタイルはバッテリーの 状態 に焦点を当てています。しきい値付きの充電 レベル 監視には Power Source タイルを使用します

熱状態

ローカルの iOS API を使用してデバイスの温度をリアルタイムで監視します(MDM 呼び出し不要)。

キー デフォルト 説明
device-checker-thermal-enabled String YES 熱状態監視タイルを有効化

例:

<key>device-checker-thermal-enabled</key>
<string>YES</string>

ステータスロジック:

緑 (Nominal) — 通常の動作温度、すべての機能が正常に動作

⚠️ 黄 (Fair) — わずかに上昇、システムはプリフェッチ/インデックス作成などのバックグラウンド作業を延期

🔴 赤 (Serious) — 高温、CPU/GPU のスロットリングがアクティブ、フレームレートが 30 FPS まで低下する場合あり

🔴 赤 (Critical) — デバイスが危険なほど高温、著しいスロットリング、カメラ/フラッシュ/スピーカーが無効になる場合あり、シャットダウンのリスク

ユースケース: 高温環境(車両、屋外作業)のフィールドデバイス、負荷の高いアプリ(ビデオ録画、AR)を実行するユーザー、熱によるシャットダウン前のプロアクティブな警告、パフォーマンスのスロットリングの把握。

注意点: iOS ProcessInfo API を介したリアルタイム監視。API 呼び出しやバッテリー消費はありません。熱状態が変化すると即座に更新されます。


パフォーマンス(メモリと CPU)

構成可能なしきい値でローカルの iOS API を使用して、デバイスのメモリ負荷と CPU 使用率を監視します。

キー デフォルト 説明
device-checker-performance-enabled String YES パフォーマンス監視タイルを有効化
device-checker-memory-warning Integer 70 メモリ警告しきい値(使用率 %)
device-checker-memory-critical Integer 85 メモリ重大しきい値(使用率 %)
device-checker-cpu-warning Integer 60 CPU 警告しきい値(使用率 %)
device-checker-cpu-critical Integer 80 CPU 重大しきい値(使用率 %)

例:

<key>device-checker-performance-enabled</key>
<string>YES</string>
<key>device-checker-memory-warning</key>
<string>70</string>
<key>device-checker-memory-critical</key>
<string>85</string>
<key>device-checker-cpu-warning</key>
<string>60</string>
<key>device-checker-cpu-critical</key>
<string>80</string>

ステータスロジック:

🔴 赤 (Critical) — メモリまたは CPU が重大しきい値以上

⚠️ 黄 (Warning) — メモリまたは CPU が警告しきい値以上(ただし重大しきい値未満)

緑 (Ready) — メモリと CPU の両方が警告しきい値未満

注意点: タイルが表示されているとき、5 秒ごとに更新されます。アプリがバックグラウンドにあるときは監視が一時停止します(バッテリー節約のため)。リモート API 呼び出しは不要 — メモリには os_proc_available_memory()、CPU には host_statistics() を使用した完全にローカルな監視です。


ネットワークステータス

WiFi、Ethernet、およびセルラー接続のステータスを監視します。

キー デフォルト 説明
device-checker-wifi-enabled String YES WiFi/Ethernet 監視タイルを有効化(接続時に Ethernet は自動検出されます)
device-checker-cellular-enabled String NO セルラー監視タイルを有効化
device-checker-network-speed-enabled String NO ネットワーク詳細ビューでネットワーク速度テストボタンを有効化

例:

<key>device-checker-wifi-enabled</key>
<string>YES</string>
<key>device-checker-cellular-enabled</key>
<string>YES</string>
<key>device-checker-network-speed-enabled</key>
<string>YES</string>

ネットワーク速度テストの詳細:

速度テストは、ダウンロード/アップロード速度とレイテンシを測定するオンデマンドの診断ツール(テストあたり約 10~15 MB、所要時間約 15~20 秒)です。セルラーでのすべてのテストの前に、データ使用量について通知する警告が表示されます。結果は情報提供のみを目的としており、デバイスの準備状態には影響しません。ユースケースには、フィールドワーカーの接続確認、パフォーマンス低下のトラブルシューティング、帯域幅要件の検証などがあります。

インターネット接続テスト(WiFi、Ethernet、セルラー)

インターフェイスの接続性だけでなく、実際のインターネット到達性を検証する軽量なテストです。

キー デフォルト 説明
device-checker-internet-connectivity-test-enabled String NO すべてのインターフェイスでインターネット接続テストを有効化
device-checker-internet-connectivity-test-endpoint String http://captive.apple.com/hotspot-detect.html テストエンドポイント URL(Apple キャプティブポータルのデフォルト)
device-checker-internet-connectivity-test-timeout String 3 リクエストタイムアウト(秒単位、1~10 の範囲)
device-checker-internet-connectivity-test-cache-ttl String 30 キャッシュ結果の有効期間(秒単位、10~300 の範囲。セルラーは最小 60 秒を使用)

例:

<key>device-checker-internet-connectivity-test-enabled</key>
<string>YES</string>
<key>device-checker-internet-connectivity-test-timeout</key>
<string>5</string>
<key>device-checker-internet-connectivity-test-cache-ttl</key>
<string>60</string>

仕組み: Apple のキャプティブポータルエンドポイントに軽量な HEAD リクエスト(約 200~500 バイト)を送信します。テストは、インターフェイスが接続されたとき、またはネットワーク詳細ビューが開かれたとき(キャッシュが期限切れの場合)に自動的に実行されます。データ使用量を最小限に抑えるため、結果は WiFi/Ethernet では 30 秒間、セルラーでは最小 60 秒間キャッシュされます。ネットワークタイルは、接続されているがインターネットが検出されない場合、黄色/警告ステータスを表示します。

インターフェイス別のステータス動作:

WiFi — 緑: 接続済みでインターネットが確認済み。黄: 接続済みだがインターネットなし(キャプティブポータル、ルーティングの問題)。赤: 未接続。

Ethernet — 緑: 接続済みでインターネットが確認済み。黄: 接続済みだがインターネットなし(ルーティング/ファイアウォールの問題)。赤: 未接続。

セルラー — 緑: 有効でインターネットが確認済み。黄: 有効だがインターネットなし(キャリアの問題、アカウントの問題)。赤: 利用不可または無効。

データ使用量: テストあたり約 200~500 バイト(速度テストの約 10~15 MB に対して)。30 秒キャッシュの WiFi/Ethernet: 通常 1 日あたり 100 KB 未満の使用量。60 秒キャッシュのセルラー: 通常 1 日あたり 50 KB 未満の使用量。

インターネット接続テストなしのステータスロジック:

WiFi: ✅ 緑 (Connected) — WiFi に接続済み。🔴 赤 (Not Connected) — WiFi に未接続。

セルラー: ✅ 緑 (Ready) — セルラーデータが利用可能。⚠️ 黄 (Warning) — セルラーアクセスが制限されています。🔴 赤 (Error) — セルラーが利用不可。


Jamf Setup 拡張属性

Jamf Pro の拡張属性から on-duty/off-duty ステータスを表示します。

キー デフォルト 説明
device-checker-jamf-setup-ea-enabled String NO Jamf Setup EA タイルを有効化
device-checker-jamf-setup-ea-name String (空) Jamf Pro の拡張属性の名前
device-checker-jamf-setup-ea-on-duty-value String (空) 「on-duty」を示す値
device-checker-jamf-setup-ea-off-duty-value String (空) 「off-duty」を示す値

例:

<key>device-checker-jamf-setup-ea-enabled</key>
<string>YES</string>
<key>device-checker-jamf-setup-ea-name</key>
<string>Jamf Setup</string>
<key>device-checker-jamf-setup-ea-on-duty-value</key>
<string>On-duty</string>
<key>device-checker-jamf-setup-ea-off-duty-value</key>
<string>Off-duty</string>

ステータスロジック:

緑 (Ready) — EA の値が on-duty の値と一致

⚠️ 黄 (Warning) — EA の値が off-duty の値と一致

グレー (Unknown) — EA が見つからないか、値が構成されたどちらの値とも一致しない

注意点: Jamf Pro にカスタム拡張属性が必要です。拡張属性は Jamf Setup または他の方法によって設定される必要があります。


自動更新のスロットリング

バックグラウンドから戻ったときにアプリが自動的に更新する頻度を制御します。

キー デフォルト 説明
device-checker-auto-refresh-threshold Integer 300 自動更新間の最小秒数(範囲: 60~3600、または 0 で無効)

例:

<key>device-checker-auto-refresh-threshold</key>
<string>300</string>

動作:

  • デフォルト(300 秒 / 5 分): ユーザーがアプリを切り替えて 5 分以内に戻った場合、自動更新は行われません
  • カスタムしきい値: 希望の秒数を設定します(60~3600)
  • スロットリングの無効化: アプリがアクティブになるたびに常に更新するには 0 に設定します

常に更新(スロットリングをバイパス): アプリ起動後の最初のアクティベーション、pending 状態のとき(2 分ごとに自動更新)、手動更新ボタンのタップ、pending 状態中のタイマー満了。

Pending 状態の動作: Apps タイルが「Pending」状態に入ると(ユーザーが「Update Apps」をタップした後)、自動更新しきい値の設定に関係なく、必要なすべてのアプリがインストールされるまでアプリは 2 分ごとにデバイスのステータスを自動的にチェックします。


構成例

最小構成(デフォルト設定)

クイックテストや基本的なデプロイメントに最適です。

<dict>
  <!-- Required keys (auto-populated) -->
  <key>JPS_URL</key>
  <string>$JPS_URL</string>
  <key>JSSID</key>
  <string>$JSSID</string>
  <key>MANAGEMENTID</key>
  <string>$MANAGEMENTID</string>
  <key>OAUTH_AUTH_CODE</key>
  <string>$OAUTH_AUTH_CODE</string>
  <key>APP_CONFIG_REINSTALL_CODE</key>
  <string>$APP_CONFIG_REINSTALL_CODE</string>
  <key>APPJSSID</key>
  <string>$APPJSSID</string>

  <!-- Enable OS monitoring only -->
  <key>device-checker-os-enabled</key>
  <string>YES</string>
  <key>device-checker-os-min-version</key>
  <string>18.0</string>
</dict>

完全構成

ブランディング、複数のデバイスステータスチェック、カスタムしきい値を備えた包括的なセットアップです。

<dict>
  <!-- Required keys (auto-populated) -->
  <key>JPS_URL</key>
  <string>$JPS_URL</string>
  <key>JSSID</key>
  <string>$JSSID</string>
  <key>MANAGEMENTID</key>
  <string>$MANAGEMENTID</string>
  <key>OAUTH_AUTH_CODE</key>
  <string>$OAUTH_AUTH_CODE</string>
  <key>APP_CONFIG_REINSTALL_CODE</key>
  <string>$APP_CONFIG_REINSTALL_CODE</string>
  <key>APPJSSID</key>
  <string>$APPJSSID</string>

  <!-- Branding -->
  <key>device-checker-branding-image-url</key>
  <string>https://yourcompany.com/logo.png</string>
  <key>device-checker-branding-image-height</key>
  <string>60</string>

  <!-- OS Readiness -->
  <key>device-checker-os-enabled</key>
  <string>YES</string>
  <key>device-checker-os-min-version</key>
  <string>18.0</string>
  <key>device-checker-os-deadline</key>
  <string>2026-12-31</string>

  <!-- App Readiness -->
  <key>device-checker-apps-enabled</key>
  <string>YES</string>
  <key>device-checker-apps-list</key>
  <string>Slack,com.tinyspeck.chatlyio,24.0.0,2026-06-01|Microsoft Teams,com.microsoft.skype.teams,5.0.0,2026-09-01</string>

  <!-- Device Health Tiles -->
  <key>device-checker-power-source-enabled</key>
  <string>YES</string>
  <key>device-checker-power-source-warning</key>
  <string>30</string>
  <key>device-checker-power-source-critical</key>
  <string>15</string>

  <key>device-checker-storage-enabled</key>
  <string>YES</string>
  <key>device-checker-storage-warning</key>
  <string>70</string>
  <key>device-checker-storage-critical</key>
  <string>85</string>

  <key>device-checker-battery-enabled</key>
  <string>YES</string>

  <key>device-checker-thermal-enabled</key>
  <string>YES</string>

  <key>device-checker-performance-enabled</key>
  <string>YES</string>
  <key>device-checker-memory-warning</key>
  <string>75</string>
  <key>device-checker-memory-critical</key>
  <string>90</string>
  <key>device-checker-cpu-warning</key>
  <string>70</string>
  <key>device-checker-cpu-critical</key>
  <string>85</string>

  <key>device-checker-wifi-enabled</key>
  <string>YES</string>
  <key>device-checker-cellular-enabled</key>
  <string>NO</string>

  <!-- Network Speed Test (optional - disabled by default) -->
  <key>device-checker-network-speed-enabled</key>
  <string>NO</string>

  <!-- Internet Connectivity Test (optional - disabled by default) -->
  <key>device-checker-internet-connectivity-test-enabled</key>
  <string>NO</string>
  <key>device-checker-internet-connectivity-test-endpoint</key>
  <string>http://captive.apple.com/hotspot-detect.html</string>
  <key>device-checker-internet-connectivity-test-timeout</key>
  <string>3</string>
  <key>device-checker-internet-connectivity-test-cache-ttl</key>
  <string>30</string>

  <!-- Jamf Setup EA -->
  <key>device-checker-jamf-setup-ea-enabled</key>
  <string>YES</string>
  <key>device-checker-jamf-setup-ea-name</key>
  <string>Device Status</string>
  <key>device-checker-jamf-setup-ea-on-duty-value</key>
  <string>Active</string>
  <key>device-checker-jamf-setup-ea-off-duty-value</key>
  <string>Spare Pool</string>

  <!-- UI Options -->
  <key>device-checker-alerts-url</key>
  <string>https://status.yourcompany.com</string>
  <key>device-checker-send-status-enabled</key>
  <string>YES</string>
  <key>device-checker-send-logs-enabled</key>
  <string>NO</string>
  <key>device-checker-status-tab-scrollable</key>
  <string>NO</string>

  <!-- Auto-Refresh (10 minutes) -->
  <key>device-checker-auto-refresh-threshold</key>
  <string>600</string>
</dict>

法的情報

この記事は役に立ちましたか?