Back to CLI Reference

$ sccfm-cli inventory devices asa upgrade trigger --help

Usage: sccfm-cli inventory devices asa upgrade trigger [OPTIONS]

  Trigger an ASA firmware/ASDM upgrade on one or more devices. Supports staging
  (download + readiness check only) or full upgrade.

Options:
  -n, --device-name TEXT       Device name to search for (supports wildcards
                               like 'branch-*').
  -q, --query TEXT             Filter devices by a Lucene query.
  -l, --limit INTEGER RANGE    Maximum records to return  [default: 50;
                               1<=x<=200]
  -o, --offset INTEGER RANGE   Pagination offset  [default: 0; x>=0]
  -u, --device-uids TEXT       List of device UIDs to upgrade.
  --software-version TEXT      Target ASA firmware version (e.g. '9.18(4)').
  --asdm-version TEXT          Target ASDM software version (e.g.
                               '7.18(1.152)').
  --stage-upgrade              Stage the upgrade only (download image +
                               readiness checks). The upgrade will NOT be
                               applied to the device.
  --force-upgrade              Force upgrade even if a staged upgrade already
                               exists on the device.
  --ignore-maintenance-window  Allow upgrade even if the device is outside its
                               maintenance window.
  --upgrade-name TEXT          Human-readable name to identify and track the
                               upgrade run.
  --check                      Run a preflight check without performing the
                               operation.
  --wait / --no-wait           Wait for the transaction to finish before
                               returning.  [default: no-wait]
  --timeout INTEGER RANGE      Maximum seconds to wait for the transaction to
                               complete (used with --wait).  [default: 3600;
                               x>=1]
  --format [table|json]        Output format  [default: table]
  --config-path PATH           Path to the configuration file (defaults to
                               ~/.sccfm-cli/config.json).
  --help                       Show this message and exit.