Skip to content

Command

MDM Magic edited this page Nov 15, 2026 · 4 revisions

Command

Find Macs or mobile devices and send them MDM commands, now or at a time you choose. ✏️ Sends commands to devices.

The tool has two tabs at the top:

  • Send Command: pick devices and send a command straight away.
  • Scheduled Commands: queue a command to be sent later. See Scheduled Commands below.

To send the same command to devices on several Jamf Pro servers at once, use Broadcast Command.

How to use it

  1. Connect to Jamf Pro and click Connect →. The tool checks Read Computers and Read Mobile Devices, and whether the account has at least one computer command privilege and at least one mobile device command privilege. You only need the rows for the device type you use. Then click Continue → (or Proceed Anyway →).

  2. Choose a Device Type: Mac Computers or Mobile Devices.

  3. Choose a Search Mode:

    • By Name: type a name, serial number or username. Matching devices are suggested as you type. Pick one, or click Search to see every match. Wildcards work, for example MBP* or *john*.
    • By Group: pick a smart or static group (Filter groups… helps), then click Load Members →.

    Devices you've used recently are listed under Recent, so you can pick them again with one click.

  4. Tick the devices you want (All and None help with long lists). Click a device's ⓘ button to see its details. Then click Choose Command →.

  5. Pick a command. Any fields it needs, such as a PIN, a message or a time zone, appear at the top so they're easy to find. Then click Review & Send →.

  6. The review screen shows Send ""? with every target device. Destructive commands are marked in red, with the warning This command is irreversible. Erased data cannot be recovered. Click Send Command.

  7. The results screen shows the devices the command was queued for, and any it couldn't be sent to. Send Another Command keeps the same devices so you can pick another command. Search Again keeps your connection, and Start Over goes back to the beginning.

Nothing is sent until you click Send Command on the review screen.

Command: search for devices

Commands

Mac Computers

Command What it does
Send Blank Push Sends a blank push to make the Mac check in with MDM
Lock Computer Locks the Mac. A 6-digit PIN is required, to unlock it, with an optional message on the lock screen
Renew MDM Profile Re-pushes the MDM enrolment profile, to fix MDM problems
Remove MDM Profile Removes the MDM profile, unenrolling the Mac from MDM. Marked in red
Wipe Computer Erases all content and settings. A 6-digit PIN is required. Marked in red
Download Updates Downloads available software updates without installing them
Download & Install Updates Downloads and installs available software updates
Enable Bluetooth / Disable Bluetooth Turns Bluetooth on or off
Enable Remote Desktop / Disable Remote Desktop Turns Screen Sharing (Apple Remote Desktop) on or off
Set Activation Lock Sets the Activation Lock bypass code on the Mac

Command: Mac commands

Mobile Devices

Command What it does
Send Blank Push Sends a blank push to make the device check in with MDM
Update Inventory Asks the device to send an updated inventory
Lock Device Locks the device, with an optional message and an optional 6-digit PIN
Clear Passcode Clears the device passcode (supervised devices only)
Clear Screen Time Passcode Clears the Screen Time (Restrictions) passcode
Restart Device / Shut Down Device Restarts or shuts down the device
Wipe Device Erases all content and settings, with an optional 6-digit PIN. Marked in red
Enable / Disable Voice Roaming Turns voice roaming on or off
Enable / Disable Data Roaming Turns data roaming on or off
Enable / Disable Bluetooth Turns Bluetooth on or off
Enable / Disable Personal Hotspot Turns Personal Hotspot on or off
Enable Lost Mode Puts the device in Lost Mode, with an optional message and phone number
Disable Lost Mode Takes the device out of Lost Mode
Play Lost Mode Sound Plays a sound on a device that's in Lost Mode
Set Wallpaper Sets the wallpaper on the lock screen and home screen
Set Activation Lock Sets the Activation Lock bypass code on the device
Renew MDM Profile Re-pushes the MDM enrolment profile
Set Time Zone Sets the time zone. Pick it from a list grouped by region. Required
Recommend Software Update Recommends a specific iOS or iPadOS version to install. Pick it from a list of iOS 17, 18 and 26 versions. Required

Command: mobile device commands


Scheduled Commands

Queue a command to be sent to chosen devices at a later date and time, for example a restart out of hours.

Scheduling a command

  1. On the Scheduled Commands tab, click Schedule Command.
  2. In Schedule a Command:
    • Enter the Jamf Pro details under Credentials used when the command fires, or pick a Saved Server.
    • Choose the Device Type and Command. If the command needs a message, phone number, PIN, time zone or version, fill it in. For a time zone or version, type the value, for example America/New_York or 17.5. A PIN must be 6 digits, and Schedule Command stays unavailable until a required PIN or value is filled in.
    • Under Target Devices, search by name or serial number and tick the devices.
    • Set the Scheduled Time. It must be in the future.
  3. Click Schedule Command.

Scheduled Commands: Schedule a Command

The list

Every scheduled command is listed with its command, device type, target devices, scheduled time and status. Filter by All, Pending, Running, Completed or Failed.

Button What it does
Run Now Sends a pending command straight away
Cancel Cancels a pending command and removes it
Remove from list Removes a finished command from the list

When a command finishes, its row shows Completed at …, or Failed with the reason.

Important: keep Magic Toolbox running

Scheduled commands are sent by Magic Toolbox on this Mac, not by Jamf Pro.

  • Magic Toolbox must be running at the scheduled time. Closing the window is fine, because the app keeps running in the menu bar.
  • The app checks for due commands every 30 seconds, starting as soon as it launches.
  • If the app wasn't running or the Mac was asleep at the scheduled time, the command is sent at the next check after the app is running again.

How credentials are kept

The Jamf Pro credentials for each scheduled command are saved in the macOS Keychain, this Mac only, until the command completes. They're deleted when the command completes, or when you Cancel or Remove it. The list itself (commands, device names and times, but no credentials) is kept in the app's preferences.


Tips

  • Commands are queued by Jamf Pro. A device that's offline gets the command the next time it checks in. Use MDM Command Queue to see whether a Mac's commands completed or failed.
  • Device Logs has a Send Command → button that opens Command with that device already selected.
  • Wipe Computer, Wipe Device and Remove MDM Profile can't be undone from Magic Toolbox. Check the target list carefully. Keep a note of the PIN you set for Lock Computer and Wipe Computer: it's needed to unlock the Mac.
  • To reinstall the Jamf management framework on a Mac, use Redeploy.

Permissions

Read Computers (Mac Computers) or Read Mobile Devices (Mobile Devices). For By Group, Read Smart Computer Groups and Read Static Computer Groups, or the mobile device equivalents.

To send commands, the account also needs the Jamf Pro privilege for each command you use. These are under Jamf Pro Server Actions in the API role, for example Send Computer Remote Command to Lock Computer or Send Mobile Device Lost Mode Command. Download Updates, Download & Install Updates and Recommend Software Update also need the privileges for Managed Software Updates. The permission screen only checks that the account has at least one send privilege of each kind, not the one for each command. A missing privilege makes the command fail for that device.

Clone this wiki locally