欢迎各位兄弟 发布技术文章
这里的技术是共享的
https://developer.jamf.com/jamf-pro/v11.0.0/reference/createcomputercommandbycommand
EraseDevice 是什么意思
EraseDevice
在 Jamf API 中的含义在 Jamf Pro API(v11.0.0)中,EraseDevice
是一个 远程擦除设备 的计算机命令(Computer Command),用于通过 Jamf Pro 向受管理的 macOS 或 iOS 设备发送 完全擦除(恢复出厂设置) 的指令。
作用:
macOS:清除所有用户数据、系统配置,恢复到初始状态。
iOS/iPadOS(Supervised 监管模式):远程擦除设备(类似 "抹掉所有内容和设置")。
擦除目标设备的所有数据和设置(类似恢复出厂设置)。
适用于:
触发方式:
通过 Jamf Pro API 发送 EraseDevice
命令(需设备已注册到 Jamf Pro)。
要求设备 在线 且能接收 Jamf Pro 的指令(否则会在下次 Check-In 时执行)。
参考 Jamf API 文档:
bashPOST /JSSResource/computercommands/command/EraseDevice/id/{deviceID}
示例(使用 curl
):
bashcurl -X POST \ -H "Authorization: Bearer YOUR_API_TOKEN" \ -H "Content-Type: application/xml" \ "https://your-jamf-server.com/JSSResource/computercommands/command/EraseDevice/id/123"
(需替换 YOUR_API_TOKEN
和 deviceID
)
设备丢失或被盗:远程擦除敏感数据。
员工离职或设备回收:清理设备以重新分配。
IT 批量管理:通过脚本或自动化工具批量擦除设备。
不可逆操作:
擦除后数据无法恢复(除非有备份)。
对 macOS 设备,可能需要重新安装操作系统(取决于设置)。
权限要求:
需要 Jamf Pro 管理员权限 和 API 访问权限。
目标设备必须被 Jamf Pro 管理(含有效的 MDM 配置文件)。
iOS/iPadOS 限制:
仅限 监管模式(Supervised) 设备支持远程擦除。
非监管设备需用户手动确认(无法强制擦除)。
macOS 特殊性:
部分 T2/Apple Silicon Mac 可能要求启用 Secure Boot 和 激活锁 策略。
如果只需部分清理(如仅删除企业数据),可改用:
WipeDevice
(保留个人数据,仅移除企业配置)。
UnmanageDevice
(移除 Jamf 管理,但不擦除数据)。
EraseDevice
是 Jamf Pro 提供的 高危操作,需谨慎使用。建议先在测试设备验证,并确保目标设备已备份关键数据。
EraseDevice 相当于格式化吗
是的,EraseDevice
在 Jamf Pro 中的功能相当于“格式化”设备,但具体效果取决于设备类型(macOS 或 iOS/iPadOS)。以下是详细对比:
恢复出厂设置(类似于 macOS 重装 + 磁盘擦除)。
会删除 所有用户数据、应用、系统设置,并回到初始状态(类似刚开箱的 Mac)。
对比项 | Jamf EraseDevice | 手动格式化(恢复 macOS) |
---|---|---|
触发方式 | 远程通过 Jamf Pro 执行 | 手动操作(恢复模式或重装) |
是否需要管理员权限 | 需要 Jamf Pro 管理员 | 需要本地管理员密码 |
是否自动重装系统 | 取决于 Jamf 策略(可搭配 InstallOS 命令) | 需手动操作 |
适用场景 | 批量管理、远程擦除丢失设备 | 单机维护 |
注意:
某些 Mac(如 T2 或 Apple Silicon 机型)可能要求 先关闭激活锁(Find My Mac),否则会失败。
擦除后通常需要重新注册到 Jamf Pro(如果启用了自动化 Enrollment)。
“抹掉所有内容和设置”(完全恢复出厂状态)。
会移除所有数据、Apple ID、MDM 配置文件(Jamf Pro 管理关系)。
对比项 | Jamf EraseDevice | 手动“抹掉所有内容和设置” |
---|---|---|
触发方式 | 远程通过 Jamf Pro MDM 执行 | 需手动进入设置操作 |
是否需要监管模式(Supervised) | 必须开启监管模式才能强制擦除 | 普通设备也可手动擦除 |
是否移除激活锁(Apple ID) | 如果启用了 “自动移除激活锁” 策略,则会解除 | 必须手动输入 Apple ID 密码解除 |
适用场景 | 企业批量管理、丢失设备远程擦除 | 个人设备重置 |
注意:
如果 iOS 设备 未开启监管模式,
EraseDevice
可能无效或需要用户确认。擦除后,设备可能仍绑定到原 Apple ID(除非已配置自动解除)。
特性 | Jamf EraseDevice | 传统格式化/手动恢复 |
---|---|---|
远程执行 | ✅(通过 Jamf Pro 后台) | ❌(需物理接触设备) |
批量操作 | ✅(可同时擦除多台设备) | ❌(单台操作) |
依赖网络 | ✅(设备需联网接收指令) | ❌(本地操作) |
企业级管理 | ✅(可结合 Jamf 策略,如自动重装系统) | ❌(纯手动) |
相当于格式化:EraseDevice
确实会像格式化一样彻底清除设备数据。
但更强大:
支持 远程触发(适合企业 IT 管理)。
可结合 Jamf Pro 策略(如擦除后自动重装系统、重新注册到 MDM)。
局限性:
对 Mac:需确保设备受 Jamf 管理,且无硬件级锁定(如 T2 芯片的激活锁)。
对 iOS:仅监管模式设备支持强制擦除。
建议:在执行前确认设备已备份重要数据,并先在测试设备验证!
https://developer.jamf.com/jamf-pro/v11.0.0/reference/createcomputercommandbycommand <computer_command>
<general>
<command>EraseDevice</command>
<passcode>123456</passcode>
</general>
<computers>
<computer>
<id>134</id>
</computer>
</computers>
</computer_command> 擦除时需要密码,到底什么时候擦除
在 Jamf Pro 中,当你通过 API 发送如下 EraseDevice
命令并要求擦除密码时:
xml<computer_command> <general> <command>EraseDevice</command> <passcode>123456</passcode> </general> <computers> <computer> <id>134</id> </computer> </computers> </computer_command>
<passcode>
字段通常用于 iOS/iPadOS 设备(非监管模式下的擦除确认),而 macOS 设备一般不需要。
对 iOS/iPadOS 设备:
如果设备 未加入监管模式 (Supervised),则通常需要用户手动输入这个密码(类似“查找我的 iPhone”的擦除确认)。
如果是 监管模式设备,则可以直接强制擦除(无需用户确认)。
对 macOS 设备:
通常不需要 <passcode>
,擦除命令会直接执行(假设设备已绑定 Jamf Pro)。
如果 Mac 启用了 FileVault 加密,可能需要管理员密码才能解锁并擦除。
取决于 设备在线状态 和 Jamf Pro 配置:
设备状态 | 擦除执行时间 | 说明 |
---|---|---|
设备在线 | 立即执行(通常在几分钟内) | Jamf Pro 会立即推送命令,设备收到后执行擦除。 |
设备离线 | 下次 Check-In 时执行 | 设备每隔几分钟~几小时会与 Jamf Pro 同步,收到命令后执行。 |
设备未响应 | 可能不会执行 | 如果设备长时间失联,擦除可能会失败。 |
Jamf Pro 后台检查:
进入 Devices > [目标设备] > Management Commands,查看 EraseDevice
的状态。
若显示 Completed
,则擦除成功。
设备端检查:
iOS/iPadOS:设备会重启并进入激活界面(类似新设备)。
macOS:设备会重启并进入恢复模式或 macOS 安装界面。
日志查询(可选):
在 Jamf Pro 的 Logs > Computer Management Logs 查看执行记录。
如果 <passcode>
错误:
iOS 设备会拒绝擦除,并可能要求重新输入密码。
macOS 设备通常不受影响(除非 FileVault 加密锁定)。
如果设备有激活锁(iCloud 锁):
非监管 iOS 设备擦除后会要求输入 Apple ID 密码。
macOS 设备需先关闭 Find My Mac,否则可能无法远程擦除。
确保设备在线:
强制设备 Check-In(如在终端执行 sudo jamf recon
)。
监管模式(iOS):
如果是企业设备,建议开启 Supervised Mode 以绕过密码限制。
备份数据:
擦除不可逆,务必先确认重要数据已备份。
如果仍有问题,可检查 Jamf Pro 日志 或联系 Jamf 支持进一步排查。