Back to CLI Reference

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

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

  Trigger an FTD firmware 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 FTD software version (e.g. '7.4.1').
                               [required]
  --stage-upgrade              Stage the upgrade only (download image +
                               readiness checks). The upgrade will NOT be
                               applied to 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.