Command Line Options

Command Line Options

This page contains a list of all available command line options. More specific details on these can be found on the various pages throughout the wiki

--days-until-reset=

• The number of days until patching completion status is changed to False
• Data Type: Integer

Command option example:
--days-until-reset=7

Command option disable example:
--days-until-reset=X

--deadline-count-focus=

• Number of deferrals allowed for incidents such as Active Display Assertions, Focus/DND mode. This type of deferral will be done silently and no prompts will be displayed for the user. Deferral time set by DeferralTimerFocus
• Data Type: Integer

Command option example:
--deadline-count-hard=3

Command option disable example:
--deadline-count-hard=X

--deadline-count-hard=

• Number of deferrals allowed by the end-user
• Data Type: Integer

Command option example:
--deadline-count-focus=3

Command option disable example:
--deadline-count-focus=X

• Example: 3

--deadline-days-focus=

• The maximum number of days that automatic deferrals are allowed if the system is in Focus/Do Not Disturb or a process has requested the display not sleep. See Days Deadlines for more details.
• Data Type: Integer

Command option example:
--deadline-days-focus=5

Command option disable example:
--deadline-days-focus=X

--deadline-days-hard=

• The maximum number of deferral days allowed before showing the deferral deadline dialog. See Days Deadlines for more details.
• Data Type: Integer

Command option example:
--deadline-days-hard=5

Command option disable example:
--deadline-days-hard=X

--deadline-days-delete-all

• Deletes all locally set days deadlines, returning to the default behavior of unlimited deferrals. See Days Deadlines for more details.
• Data Type: trigger only

Command option example:
--deadline-days-delete-all

--deferral-timer-default=

• The number of minutes to defer until the next update workflow attempt if a user chooses not to install updates
• Data Type: Integer

Command option example:
--deferral-timer-default=1440

Command option disable example:
--deferral-timer-default=X

--deferral-timer-error=

• Amount of time in Minutes that AAP will defer if any errors are detected throughout the process
• Data Type: Integer

Command option example:
--deferral-timer-error=60

Command option disable example:
--deferral-timer-error=X

--deferral-timer-focus=

• Amount of time in Minutes that AAP will defer for Focus/DND/Display Assertions. Requires the use of DeadlineCountFocus. If no DeferralTimerFocus is set it will default to DeferralTimerDefault
• Data Type: Integer

Command option example:
--deferral-timer-focus=60

Command option disable example:
--deferral-timer-focus=X

--deferral-timer-menu=

• Allows you to provide multiple deferral time options instead of the default of one day (minutes,minutes,etc...)
• Data Type: String

Command option example:
--deferral-timer-menu=30,60,480,720,1440

Command option disable example:
--deferral-timer-menu=X

--deferral-timer-workflow-relaunch=

• Amount of time in minutes until AAP is relaunched after a workflow
• Data Type: Integer

Command option example:
--deferral-timer-workflow-relaunch=1440

Command option disable example:
--deferral-timer-workflow-relaunch=X

--force-discovery

• Forces the app-discovery (scanning) phase to run immediately on the very next run, even if DiscoveryFrequency hasn't elapsed yet. It's a one-shot trigger: it applies once and then automatically clears itself - including when the run is relaunched via the LaunchDaemon (e.g. triggered remotely through Jamf), so it still takes effect even though the relaunched process doesn't see the original command-line flag.
• Data Type: trigger only
• Note: an administrator-disabled discovery workflow (WorkflowDisableAppDiscovery) still takes priority - --force-discovery only bypasses the DiscoveryFrequency wait, not a hard disable.

Command option example:
--force-discovery

--discovery-frequency=

• Skips the app-discovery (scanning) phase on subsequent runs within this configurable time window (in hours). See Discovery Frequency for more details.
• Data Type: Integer

Command option example:
--discovery-frequency=24

Command option disable example:
--discovery-frequency=0

--dialog-icon-option=

• Sets a custom icon for specific dialogs, such as the deferral dialog
• Data Type: String

Command option example:
--dialog-icon-option=filepath|URL

--ignored-labels="label1 label2"

• A space-separated list of Installomator labels to ignore for the AAP workflow. Supports wilddcards
• Data Type: String

Command option example:
--ignored-labels="microsoft* googlechrome*"

--interactiveMode=

• Data Type: Integer
• Options: 0 (Completely Silent) | 1 (Silent Discovery, Interactive Patching) | 2 (Full Interactive) (default)

--optional-labels="label1 label2"

• A space-separated list of optional Installomator labels. Labels in this category are only included if the app exists on the end-users device and will force install even if its the latest version. Does Not Support Wildcards
• Data Type: String

Command option example:
--optional-labels="iterm2 googlechromepkg"

--patch-week-start-day=

• The day of week to set the start date for a recurring patching cadence
• Data Type: Integer
• Options: 1 through 7 (1=Mon 2=Tue...7=Sun)

Command option example:
--patch-week-start-day=2

Command option disable example:
--patch-week-start-day=X

--required-labels=

• a space-separated list of Installomator labels that are required, regardless if the app is installed or or the latest version. Supports wildcards.
• Data Type: String

Command option example:
--required-labels="desktoppr dockutil nudgesuite"

--reset-labels

• Clears any saved labels in the local configuration profile
• Data Type: trigger only\

Command option example:
--reset-labels

Self Update Check

--force-self-update-check

• will force a one time self update check

--self-update-enabled --self-update-disabled

• Enables or Disables automatic self update check

--self-update-frequency=daily|weekly|monthly

• Determines how frequently AAP will run a self update check

--zoom-call-active-check-enabled / --zoom-call-active-check-disabled

• Enables or disables the Zoom Call Active Check, which skips updating Zoom if the user starts a call after choosing to install updates.
• Data Type: trigger only

Command option example:
--zoom-call-active-check-enabled
--zoom-call-active-check-disabled

--webhook-url-slack=

• The Slack Webhook URL to use if WebhookFeature is set to TRUE
• Data Type: String

Command option example:
--webhook-url-slack=https://webhook.slack.com/YourSlackWebhookURL

--webhook-url-teams=

• The Teams Webhook URL to use if WebhookFeature is set to TRUE

Command option example:
--webhook-url-teams=https://webhook.teams.com/YourTeamsWebhookURL

--mosyle-console-url=

• Optional Mosyle admin console host for Slack/Teams View in Mosyle links. Use this when the default Business/Education mapping is wrong for your tenant.
• Data Type: String

Command option example:
--mosyle-console-url=https://mybusiness.mosyle.com

Version 3.7 Options and Triggers

--business-hours=

Sets blocked weekday windows. See Business Hours.

--business-hours="MON:09:00-17:00,TUE:09:00-17:00"

--business-hours-allow-discovery / --business-hours-allow-discovery-off

Enables or disables discovery/report refreshes during Business Hours without patching or dialogs.

--business-hours-respect-hard-deadline / --business-hours-respect-hard-deadline-off

Controls whether Business Hours remains enforced after a hard deadline.

--business-hours-silent-during / --business-hours-silent-during-off

Enables or disables discovery plus closed-app silent patching during Business Hours.

--excluded-background-labels=

Sets labels that remain discoverable but are excluded from silent/background updates. Wildcards are supported.

--excluded-background-labels="amazoncorretto* node python"

--pending-apps-dialog

Displays the current report queue without discovery. Install Now patches exactly that queue; Later preserves the existing schedule. See Notifications and Pending Apps.

--preview-deferral-dialog

Displays the deferral dialog with sample apps for appearance/language testing. Does not discover, patch, or change NextAutoLaunch.

--show-dock-icon / --show-dock-icon-off

Enables or disables the AAP Dock icon and pending/remaining badges.

--show-notifications-all / --show-notifications-all-off

Controls the master notification setting. --show-notifications and --show-notifications-off are aliases.

--show-notifications-apps-queued / --show-notifications-apps-queued-off

Controls queued-app notifications when the master setting is off.

--show-notifications-silent-and-queued / --show-notifications-silent-and-queued-off

Controls combined silent-updated/remaining-queued notifications when the master setting is off.

--show-notifications-silent-updated / --show-notifications-silent-updated-off

Controls silent-update completion notifications when the master setting is off.

--skip-pre-update-verification / --skip-pre-update-verification-off

Controls the local Gatekeeper/Team ID discovery check. Installomator's post-download validation remains active.

--stop

Gracefully stops the active AAP process tree and preserves a safe future schedule. Must run as root. See Process Recovery.

sudo appautopatch --stop

--workflow-discovery-only

Runs an immediate one-shot headless discovery/report refresh without replacing the existing schedule. See Scheduled Discovery and User-Driven Patching.

Additional Command Line Triggers

Information can be found regarding these triggers throughout the wiki

--deadline-count-delete-all

--debug-mode

--debug-mode-off

--deferral-timer-reset-all

--help

--reset-defaults

--reset-labels

--uninstall

--usage

--verbose-mode

--verbose-mode-off

--version | --vers

--webhook-feature-all

--webhook-feature-failures

--webhook-feature-off

--workflow-disable-app-discovery

--workflow-disable-app-discovery-off

--workflow-disable-relaunch

--workflow-disable-relaunch-off

--workflow-install-now

--workflow-install-now-silent

--workflow-install-now-patching-status-action-never

--workflow-install-now-patching-status-action-always

--workflow-install-now-patching-status-action-success

More detail on the --workflow-install-now* triggers can be found on the Workflows page.