為何要使用 Jamf Device Checker?
問題所在
終端使用者經常遇到影響工作效率的裝置問題,卻不知道如何找出或解決:
- App 版本遺失或過舊
- iOS 版本過舊
- 電池健康度偏低導致意外關機
- 儲存容量問題導致無法安裝 App
- 網路連線問題影響工作效率
- 裝置過熱造成效能節流
- 記憶體/CPU 使用率過高拖慢工作
這些問題通常會演變成服務台工單、生產力損失,以及使用者的挫折感。
解決方案
Jamf Device Checker 透過簡單、以顏色標示的介面,讓終端使用者能自行診斷並解決裝置就緒問題:
- ✅ 綠色 = 裝置已就緒可供工作
- ⚠️ 黃色 = 應盡快處理的警告
- 🔴 紅色 = 阻礙生產力的嚴重問題
主要優點
對終端使用者: 自助式裝置就緒檢查、清楚且可據以行動的問題修正指引、縮短等待 IT 支援的時間,以及在期限前主動發出通知。
對 IT 團隊: 減少服務台工單、強制執行企業政策合規(作業系統版本、必要 App)、即時掌握裝置健康狀況的能見度,以及可設定的閾值與監控規則。
對組織: 提升終端使用者生產力、更完善的裝置生命週期管理、降低 IT 支援成本,以及合規追蹤與報表。
整體狀態顯示
App 會在主畫面頂端顯示一個大型、以顏色標示的狀態指示器,用以總結裝置的整體就緒情形。
| 狀態 | 顏色 | 圖示 | 說明 |
|---|---|---|---|
| Ready | 🟢 綠色 | 勾選符號 | 所有已啟用的檢查皆通過。裝置符合所有需求。 |
| Deadline Approaching | 🟠 橘色 | 警告三角形 | 有可用的更新且已設定期限。顯示「X update(s) available - Y day(s) remain」,並倒數至最近的期限。 |
| Action Needed | 🟠 橘色 | 警告三角形 | 有可用的更新,但未設定期限。顯示「X update(s) available」。 |
| Not Ready | 🔴 紅色 | X 符號 | 有一項以上的更新為必要,且期限已過。顯示「X update(s) required」。 |
| Installing Updates | 🔵 藍色 | 旋轉箭頭 | MDM 指令執行中。顯示 2 分鐘倒數計時器以自動重新整理。 |
| Off Duty | ⚪ 灰色 | 帶 Z 的月亮 | 裝置透過 Jamf Setup EA 標示為離勤。 |
| Unknown | ⚪ 灰色 | 問號 | 首次檢查完成前的初始狀態。 |
快速開始
先決條件
- Jamf Pro 伺服器 (JPS)
- Jamf Pro 的管理員存取權
- Jamf Self Service App(App 安裝功能所需)
- 具備精靈權限的本機使用者帳號(見下方)
所需 API 權限
App 使用兩組不同的權限:
精靈設定用(本機使用者帳號 — 於初始組態期間使用):
在 Jamf Pro 中建立一個具備下列 8 項權限的本機使用者:
API Integration 設定(一次性精靈組態):
- 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 integration、設定角色、連結原生 App,並儲存 app config XML。初始設定完成後,此使用者僅在更新 app config 時需要用到(只需 2 項 Mobile Device Applications 權限)。
執行階段運作用(OAuth API 用戶端 — 由精靈自動設定):
精靈會自動建立一個「Jamf Device Checker」API 角色,並將下列 4 項權限指派給已連結的 App integration:
- 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:購買 App 並新增至 Jamf Pro
- 在 AxM 中購買「Jamf Device Checker」並指派至 Jamf Pro 執行個體
- 在 Jamf Pro 中前往 Mobile Device Apps
- 從 Apps Purchased in Volume 新增「Jamf Device Checker」
步驟 2:執行設定精靈
- 在你的管理裝置上安裝 App
- 啟動 App,長按圓形狀態圖示以啟用 Wizard 模式
- 使用本機使用者進行驗證(需要 8 項精靈權限 — 見上方「所需 API 權限」)
- 依照精靈完成下列動作:
- 設定具備所需權限的 API 角色
- 建立 API integration
- 將原生 App 連結至 API integration 以進行驗證
- 產生 managed app config 並儲存至 JPS
沒有步驟 3 — 只要把範圍設定到終端使用者裝置即可。
完整設定說明
步驟 1:將 Mobile Device App 新增至 Jamf Pro
- 在 AxM 中購買「Jamf Device Checker」並指派至 Jamf Pro 執行個體
- 登入 Jamf Pro
- 前往 Devices > Mobile Device Apps
- 按一下 + New
- 在 Apps Purchased in Volume 中搜尋 「Jamf Device Checker」
- 按一下 Add,將 App 記錄新增至你的 Jamf Pro 執行個體
步驟 2:執行設定精靈
精靈會自動處理所有驗證與 managed app 組態。
在管理裝置上安裝 App
- 將 App 指派給一台測試 iOS 裝置
- 啟動 Jamf Device Checker
啟用 Wizard 模式
- 在 More 分頁上,長按 App 圖示 3 秒
- 選取 Wizard Setup
- 使用在「先決條件」中建立的本機使用者憑證進行驗證(需要 8 項精靈權限)
完成精靈步驟
API Role
- 精靈會檢查是否已有「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 integration
Native App Authentication
- 精靈會將行動裝置 App 記錄連結至 API integration
- 透過 Managed App Config 啟用 OAuth authorization code 的遞送
Generate App Config
- 精靈會產生完整的 Managed App Config
- 傳送至 Jamf Pro
步驟 3:設定範圍至裝置
- 在相同的 App 記錄中,按一下 Scope
- 新增目標裝置群組、smart group 或個別裝置
- 按一下 Save
組態參考
App 完全透過 Jamf Pro 的 Managed App Config 進行設定。以下是所有可用索引鍵的完整參考。
必要索引鍵
這些索引鍵由 Jamf Pro 自動填入 — 請勿修改或移除。
| Key | 說明 |
|---|---|
JPS_URL |
Jamf Pro 伺服器 URL(自動填入:$JPS_URL) |
JSSID |
裝置 JSS ID(自動填入:$JSSID) |
MANAGEMENTID |
裝置 Management ID(自動填入:$MANAGEMENTID) |
OAUTH_AUTH_CODE |
OAuth authorization code(自動填入:$OAUTH_AUTH_CODE) |
APP_CONFIG_REINSTALL_CODE |
重新安裝觸發碼(自動填入:$APP_CONFIG_REINSTALL_CODE) |
APPJSSID |
Jamf Device Checker App 記錄 ID(自動填入:$APPJSSID) |
品牌識別與警示 URL
| Key | 類型 | 預設值 | 說明 |
|---|---|---|---|
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 分頁中狀態分享與記錄匯出功能的顯示與否。
| Key | 類型 | 預設值 | 說明 |
|---|---|---|---|
device-checker-send-status-enabled |
String | YES |
顯示「Send Status」按鈕(透過電子郵件/訊息分享裝置就緒摘要) |
device-checker-send-logs-enabled |
String | YES |
顯示「Send Logs」按鈕(匯出 App 記錄以供疑難排解) |
範例:
<key>device-checker-send-status-enabled</key>
<string>YES</string>
<key>device-checker-send-logs-enabled</key>
<string>NO</string>
UI 行為
控制 Status 分頁的捲動行為。
| Key | 類型 | 預設值 | 說明 |
|---|---|---|---|
device-checker-status-tab-scrollable |
String | NO |
設為 YES 時,整個 Status 分頁皆可捲動(標頭 + 整體狀態 + 磚塊)。設為 NO(預設)時,標頭與整體狀態維持固定,僅下方磚塊可捲動。 |
範例:
<key>device-checker-status-tab-scrollable</key>
<string>NO</string>
何時啟用: 預設值 (NO) 最適合大多數部署 — 捲動磚塊時,標頭與整體就緒狀態仍維持可見。若你需要整個檢視一起捲動,或要在較小的裝置上容納較長的品牌標頭,則設為 YES。
作業系統就緒
透過可設定的最低版本與期限來監控 OS 版本需求。
| Key | 類型 | 預設值 | 說明 |
|---|---|---|---|
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 版本低於最低值,且期限已過
App 就緒
監控必要 managed app 的安裝狀態與版本需求。
| Key | 類型 | 預設值 | 說明 |
|---|---|---|---|
device-checker-apps-enabled |
String | NO |
啟用 App 監控磚塊 |
device-checker-apps-list |
String | (空白) | 以直線分隔的 App 清單(格式見下方) |
App 清單格式:
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) — 所有 App 皆已安裝並符合最低版本
⚠️ 黃色 (Warning) — 有一項以上的 App 需要更新,但期限尚未過
🔴 紅色 (Not Ready) — 有一項以上的 App 需要更新,且期限已過
⏳ Pending — App 安裝進行中(見下方 Self Service 整合)
Self Service 整合:
當 App 遺失或過舊時,使用者可點按 Apps 磚塊上的 「Update Apps」 按鈕,自動安裝或更新必要的 App。流程如下:
- 使用者點按 Apps 磚塊上的「Update Apps」按鈕
- Jamf Self Service App 自動開啟,並將遺失/過舊的 App 排入佇列
- Device Checker 進入「Pending」狀態並啟動 2 分鐘的自動重新整理計時器
- App 每 2 分鐘自動重新整理,以檢查安裝是否完成
- 一旦所有 App 皆符合需求,狀態會恢復為綠色
需求: 裝置上必須安裝 Jamf Self Service,App 必須在 Self Service 中可用且已設定範圍至該裝置,並且 App 在 Jamf Pro 中必須勾選「Display app in Self Service after it is installed」。
注意事項:
- Bundle ID 必須完全相符(區分大小寫)
- 版本比較使用語意化版本(例如
2.5.0>2.4.9) - 期限為選用(若不需要則留白:
AppName,bundleID,minVersion,)
電源(電池電量)
透過可設定的警告與嚴重閾值來監控電池充電電量。
| Key | 類型 | 預設值 | 說明 |
|---|---|---|---|
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) — 電池 > 警告閾值
⚡ Charging — 裝置已接上電源(充電時一律為綠色)
儲存容量
透過可設定的警告與嚴重閾值(依已使用百分比計算)來監控可用儲存空間。
| Key | 類型 | 預設值 | 說明 |
|---|---|---|---|
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) — 已使用儲存空間 < 警告閾值
電池健康度
監控電池健康狀態,以找出可能需要更換電池的裝置。此磚塊會顯示電池健康狀態與目前的充電百分比。
| Key | 類型 | 預設值 | 說明 |
|---|---|---|---|
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 呼叫)即時監控裝置溫度。
| Key | 類型 | 預設值 | 說明 |
|---|---|---|---|
device-checker-thermal-enabled |
String | YES |
啟用熱狀態監控磚塊 |
範例:
<key>device-checker-thermal-enabled</key>
<string>YES</string>
狀態邏輯:
✅ 綠色 (Nominal) — 正常運作溫度,所有功能正常運作
⚠️ 黃色 (Fair) — 略微升高,系統延後背景工作(例如預先擷取/索引)
🔴 紅色 (Serious) — 溫度偏高,CPU/GPU 節流啟動,畫面更新率可能降至 30 FPS
🔴 紅色 (Critical) — 裝置嚴重過熱,出現明顯節流,相機/閃光燈/喇叭可能停用,有關機風險
使用情境: 於高溫環境(車輛、戶外作業)中的現場裝置、執行高耗能 App(錄影、AR)的使用者、在熱關機前主動警告,以及理解效能節流。
注意事項: 透過 iOS ProcessInfo API 進行即時監控。不需 API 呼叫,也不會耗電。熱狀態變更時會立即更新。
效能(記憶體與 CPU)
使用本機 iOS API 搭配可設定的閾值,監控裝置記憶體壓力與 CPU 使用率。
| Key | 類型 | 預設值 | 說明 |
|---|---|---|---|
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 秒更新一次。App 進入背景時暫停監控(以節省電力)。不需遠端 API 呼叫 — 完全透過本機監控,記憶體使用 os_proc_available_memory(),CPU 使用 host_statistics()。
網路狀態
監控 WiFi、Ethernet 與行動網路連線狀態。
| Key | 類型 | 預設值 | 說明 |
|---|---|---|---|
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 與行動網路)
輕量測試,用以驗證實際的網際網路可連線性,而非僅是介面連線。
| Key | 類型 | 預設值 | 說明 |
|---|---|---|---|
device-checker-internet-connectivity-test-enabled |
String | NO |
為所有介面啟用網際網路連線測試 |
device-checker-internet-connectivity-test-endpoint |
String | http://captive.apple.com/hotspot-detect.html |
測試端點 URL(Apple captive portal 預設值) |
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 的 captive portal 端點傳送一個輕量的 HEAD 要求(約 200–500 位元組)。當介面連接時,或開啟網路詳細檢視時(若快取已過期)會自動執行測試。結果在 WiFi/Ethernet 上快取 30 秒,在行動網路上最少快取 60 秒,以將資料用量降至最低。若已連線但未偵測到網際網路,網路磚塊會顯示黃色/警告狀態。
各介面的狀態行為:
WiFi — 綠色:已連線且已驗證有網際網路。黃色:已連線但無網際網路(captive portal、路由問題)。紅色:未連線。
Ethernet — 綠色:已連線且已驗證有網際網路。黃色:已連線但無網際網路(路由/防火牆問題)。紅色:未連線。
Cellular — 綠色:已啟用且已驗證有網際網路。黃色:已啟用但無網際網路(電信業者問題、帳號問題)。紅色:不可用或已停用。
資料用量: 每次測試約 200–500 位元組(相較於速度測試約 10–15 MB)。WiFi/Ethernet 搭配 30 秒快取:典型用量每日低於 100 KB。行動網路搭配 60 秒快取:典型用量每日低於 50 KB。
未啟用網際網路連線測試時的狀態邏輯:
WiFi: ✅ 綠色 (Connected) — 已連線至 WiFi。🔴 紅色 (Not Connected) — 未連線至 WiFi。
Cellular: ✅ 綠色 (Ready) — 行動數據可用。⚠️ 黃色 (Warning) — 行動網路存取受限。🔴 紅色 (Error) — 行動網路不可用。
Jamf Setup Extension Attribute
顯示來自 Jamf Pro extension attribute 的在勤/離勤狀態。
| Key | 類型 | 預設值 | 說明 |
|---|---|---|---|
device-checker-jamf-setup-ea-enabled |
String | NO |
啟用 Jamf Setup EA 磚塊 |
device-checker-jamf-setup-ea-name |
String | (空白) | Jamf Pro 中 extension attribute 的名稱 |
device-checker-jamf-setup-ea-on-duty-value |
String | (空白) | 代表「在勤」的值 |
device-checker-jamf-setup-ea-off-duty-value |
String | (空白) | 代表「離勤」的值 |
範例:
<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 值與在勤值相符
⚠️ 黃色 (Warning) — EA 值與離勤值相符
⚪ 灰色 (Unknown) — 找不到 EA,或值與任一已設定的值皆不相符
注意事項: 需要 Jamf Pro 中的自訂 extension attribute。該 extension attribute 必須由 Jamf Setup 或其他方法填入。
自動重新整理節流
控制 App 從背景返回時自動重新整理的頻率。
| Key | 類型 | 預設值 | 說明 |
|---|---|---|---|
device-checker-auto-refresh-threshold |
Integer | 300 |
自動重新整理之間的最短秒數(範圍:60–3600,或設為 0 以停用) |
範例:
<key>device-checker-auto-refresh-threshold</key>
<string>300</string>
行為:
- 預設(300 秒/5 分鐘): 若使用者切換 App 並在 5 分鐘內返回,不會發生自動重新整理
- 自訂閾值: 設為想要的秒數(60–3600)
- 停用節流: 設為
0,App 變成作用中時一律重新整理
一律重新整理(略過節流): App 啟動後的首次作用、處於 pending 狀態時(每 2 分鐘自動重新整理)、手動點按重新整理按鈕,以及 pending 狀態期間的計時器到期。
Pending 狀態行為: 當 Apps 磚塊進入「Pending」狀態(在使用者點按「Update Apps」之後),App 會每 2 分鐘自動檢查裝置狀態,直到所有必要 App 皆已安裝為止,不受自動重新整理閾值設定影響。
組態範例
最精簡組態(預設設定)
適合快速測試或基本部署。
<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>