Enforcing a Minimum macOS Version During Automated Device Enrollment

Jamf Pro Documentation 11.16.0

Solution
Application
Content Type
Technical Documentation
Utilities & Services
version
11.16.0
ft:locale
en-US
vrm_version
11.16.0

PreStage enrollments allow you to enforce a minimum macOS version that a computer must have before the computer enrolls with Jamf Pro. If a computer does not have the macOS version you specified in Jamf Pro, the user is prompted to update the operating system on the computer before Setup Assistant continues during Automated Device Enrollment.

Keep the following in mind:

  • If the Apple Software Update Lookup Service determines the enrolling computer is ineligible for the selected update version, the device will continue enrollment without requiring the update.

  • Software updates will fail during Setup Assistant on versions of macOS 14 if an incompatible version is selected from the Minimum macOS version to enforce pop-up menu. Workaround: Choose "Latest minor version", "Latest major version", or "Latest version based on computer eligibility" from the Minimum required macOS version pop-up menu. These options allow Jamf Pro to query Apple's update servers for eligibility during enrollment.

Requirements

Computers in the PreStage enrollment with macOS 14.4 or later

  1. In Jamf Pro, click Computers in the sidebar.
  2. Click PreStage Enrollments in the sidebar.
  3. On the PreStage Enrollments page, do one of the following:
    • Click New to create a new PreStage enrollment.

    • Select an existing PreStage enrollment and click Edit .

  4. In the General pane, choose one of the following options from the Minimum required macOS version pop-up menu:
    • No enforcementUsers are not prompted to install an update during enrollment. This is the default setting in Jamf Pro.
    • Latest version based on computer eligibilityUsers are prompted to install the latest macOS version based on the computer's eligibility.
    • Latest major versionUsers are prompted to install the latest major macOS version.
    • Latest minor versionUsers are prompted to install the latest minor macOS version.
    • Specific versionUsers are prompted to install the macOS version specified in the Minimum macOS version to enforce pop-up menu. If the version selected is no longer listed as available from Apple at time of enrollment, enforcement will be skipped.
  5. Click Save .

Users are prompted to update to a version of macOS during Automated Device Enrollment based on the options selected.