-
Notifications
You must be signed in to change notification settings - Fork 0
3.0 xadm help add version
Chris Lasell edited this page May 18, 2026
·
3 revisions
Command:
add-version, Add a new version to a title, making it available for piloting
Description:
The version will be automatically installed or updated on any computers
in the 'pilot-groups' defined for the version. To manually install it
on other computers, you must use 'xolo install <title> <version>'.
Usage:
xadm [global options] add-version title version [options]
Arguments:
title: The unique name of a title in Xolo, e.g. 'google-chrome'
Must be lowercase alphanumeric and dashes only.
version: The version of the title you are working with. e.g. '12.34.5'
Options:
-d, --publish-date=<s> The date this version was released by the publisher.
Default is today.
Only used with managed titles.
-o, --min-os=<s> The lowest version of macOS able to run this version of this title. Defaults to a value
set in the server config, or 10.9.
Only used with managed titles.
-O, --max-os=<s> The highest version of macOS able to run this version of this title.
Only used with managed titles.
-r, --reboot The installation of this version requires the computer to reboot. Users will be
notified before installation.
To remove the reboot option, use --no-reboot.
Only used with managed titles.
-s, --standalone The installer for this version is a full installer, not an incremental patch that must
be installed on top of an earlier version.
To remove the standalone option, use --no-standalone.
Only used with managed titles.
-k, --killapps=<s> A killapp is an application that cannot be running while this version is installed.
If running, installation is delayed, and users are notified to quit.
Killapps are defined by an app name e.g. 'Google Chrome.app', and the app's Bundle ID
e.g. 'com.google.chrome'.
Specify them together separated by a semi-colon, e.g.
'Google Chrome.app;com.google.chrome'
If the title for this version has a defined --app-name and --app-bundle-id, you can
use them as a killapp by specifying 'use-title'
If not using --walkthru you can use --killapps multiple times
To remove all killapps, use 'none'.
Only used with managed titles.
-U, --patch-unknown Should 'unknown' versions of this title be updated to this version automatically by
Jamf Patch Management?
When Jamf Patch determines that a title is installed on a computer, but version
reported is not among those known to Jamf Patch, it marks the version as 'unknown'.
Setting this option to true will cause Jamf Patch to automatically install the pkg for
this version on those Macs with 'unknown' versions.
This can cause problems if that unknown version is actually newer than this version,
e.g. a beta or pre-release version, or when the app has a 'self-update' mechanism that
installs newer versions outside of Jamf Patch before it is aware of them.
But sometimes it may be desirable to have all unknown versions updated to this version,
e.g. when the title is a helper app that is not regularly updated, or when the title is
being newly managed by Xolo/Jamf Patch and you want to get all existing installations
onto this version.
To remove the patch-unknown option, use --no-patch-unknown.
-p, --pilot-groups=<s> One or more Jamf Computer Groups whose members will automatically have this version
installed or updated for testing before it is released.
These computers will be used for testing not just the software, but the installation
process itself. Exclusions win, so computers that are also in an excluded group for the
title will not be used as pilots.
When this version is released, the computers in the release_groups defined in the title
will automatically have this version installed - and any computers with an older
version will have it updated.
When using the --pilot-groups CLI option, you can specify more than one group by using
the option more than once, or by providing a single option value with the groups
separated by commas.
When adding a new version, the pilot groups from the previous version will be inherited
if you don't specify any. To make the version have no pilot groups use 'none'.
NOTE: Any non-excluded computer can be used for piloting at any time by manually
installing the yet-to-be-released version using `sudo xolo install <title> <version>`.
The members of the pilot groups are just the ones that will have it auto-installed.
-u, --pkg-to-upload=<s> The path to a local copy of the installer package for this version. Will be uploaded to
Xolo and then Jamf Pro distribution point(s), replacing any previously uploaded.
Must be a flat .pkg file, or a .zip compressed old-style bundle package.
It will be renamed to 'xolo-<title>-<version>.pkg' (or .zip).
If your Xolo server is confiured to sign unsigned packages, it will do so along the
way.
Required when creating a new version unless the title is configrued to use autopkg.
-h, --help Show this message