iOS device commands

Pushes and applies the latest profile and app information to the device.

Shared iPads with an active Managed Apple ID user session require the Knox Manage agent to be installed and running for this device command to function.

iOS

iPadOS

User Enrollment

iOS

iPadOS

User Enrollment

iOS

iPadOS

User Enrollment

iOS

iPadOS

iOS

iPadOS

Supervised

iOS

iPadOS

Supervised

Resets the device's screen lock password.

iOS

iPadOS

Initializes the block settings of the device.

iOS

iPadOS

Supervised

Updates the device to the latest iOS version. Select the Update Method:

• Download or Install — Depending on the current state of the device, downloads or installs the OS update. This command doesn't perform both actions in sequence. If the update isn't downloaded to the device, then this command begins downloading the update data. If the update is downloaded on the device, then this command installs the update.
• Download Only
• Install Only

iOS

iPadOS

Supervised

Enables Lost Mode on the device for scenarios where it's lost or stolen. When sending this device command, you must submit the following information:

• Message — Enter a message to display in the center of the lock screen.
• Phone Number — Enter a phone number that the device user or you can be reached at.

You can also submit the following optional settings:

• Footnote — Enter a message to display at the bottom of the lock screen.
• Locate Device — Select this option to collect location information about the device, even if Location Services is disabled.

iOS

iPadOS

Supervised

iOS

iPadOS

Supervised

For more information, see Prepare to use eSIMs with Apple devices in the Apple developer documentation.

iOS

iPadOS

Supervised

iOS

iPadOS

iOS

iPadOS

Installs an app on the device.

On the Request Command screen, select the app that you want to install.

iOS

iPadOS

Uninstalls an app from the device.

On the Request Command screen, select the app you want to uninstall.

iOS

iPadOS

Sends the latest internal app information and updates the device according to the information.

Shared iPads with an active Managed Apple ID user session require the Knox Manage agent to be installed and running for this device command to function.

iOS

iPadOS

Sends an emergency message to the device. You can add a push notification message of up to 80 characters. On the Push Notification page, enter the title and content of the message.

On iPhones, the notification title and message show on the lock screen and in the Notification Center.

For shared iPads with an active Managed Apple ID user session, the Knox Manage agent must be installed for this command to function.

iOS

iPadOS

iOS

iPadOS

User Enrollment

iOS

iPadOS

Updates the device user information such as the user activation status, username, user settings—such as Secure Browser website URL information and bookmark information—as well as license information.

If the user is signed out from the enrolled device, you can send this command to enable the user to sign in to Knox Manage automatically.

Shared iPads with an active Managed Apple ID user session require the Knox Manage agent to be installed and running for this device command to function.

iOS

iPadOS

Locks the Knox Manage agent.

When the agent is locked, the device user must enter the agent's password that was configured during enrollment. If the user forgets the password, you can send the Delete Account command to sign out the user. Then, they can reset the password upon sign in.

Shared iPads with an active Managed Apple ID user session require the Knox Manage agent to be installed and running for this device command to function.

iOS

iPadOS

Unlocks the Knox Manage agent.

Shared iPads with an active Managed Apple ID user session require the Knox Manage agent to be installed and running for this device command to function.

iOS

iPadOS

iOS

iPadOS

Collects the Knox Manage audit logs of the device. When the log size exceeds the maximum size, logs are automatically sent to the server, but the log file may be lost. For more detailed information, see Viewing audits.

Shared iPads with an active Managed Apple ID user session require the Knox Manage agent to be installed and running for this device command to function.

iOS

iPadOS

Collects the logs of devices.

Shared iPads with an active Managed Apple ID user session require the Knox Manage agent to be installed and running for this device command to function.

iOS

iPadOS

Collects the device log to diagnose the cause of device lock.

Shared iPads with an active Managed Apple ID user session require the Knox Manage agent to be installed and running for this device command to function.

iOS

iPadOS

iOS

iPadOS

Shows the current location of the device.

To view the location of the device after sending this command, navigate to Device, click the check box for the device, and then click Check Location. Each time you send the command to collect current location, the user must consent to collecting device location data. Alternatively, the device user can provide consent to collect location data as a background process.

Before you can collect location data from the device as a background process, the following prerequisites must be met:

• KM agent configuration — You must allow the Knox Manage agent to collect location data. Go to Setting > Configuration > Knox Manage Agent Policy > Allow Collecting Location Data > set to Allow.
• User consent — When the device prompts the user to allow collection of location data by the Knox Manage agent, the device user must select Always Allow.

After these prerequisites are met, the device's location data is collected whenever the device moves 500 meters or more, and this device command is functional. Location history for iOS devices is stored for 30 days from the last collection date.

Shared iPads with an active Managed Apple ID user session require the Knox Manage agent to be installed and running for this device command to function.

iOS

iPadOS

Updates the inventory and app information on the device.

iOS

iPadOS

User Enrollment

Pulls the device's app list.

You have the option to delete app feedback when sending this device command.

iOS

iPadOS

Checks the service connection status of the device.

To check the status of the device after sending this command, navigate to Device, click the device name or tag, click the Security tab, and view the connection status below the device name.

For information on the different connection statuses, see Device connection statuses.

iOS

iPadOS

User Enrollment

Collects the ID of the profile applied to the device.

If the device was enrolled, then the ID is automatically collected from the device's inventory information without sending the device command.

iOS

iPadOS

User Enrollment