Configuration Automation - Ping CLI

pingcli mfa device-policies replace

Update an MFA device policy

Synopsis

Update (replace) an MFA device policy in a PingOne environment with a full-body replacement

pingcli mfa device-policies replace [flags]

Examples

  # Update an MFA device policy from a JSON file (--environment-id and --mfa-device-policy-id are still required)
  pingcli mfa device-policies replace --environment-id <env-id> --mfa-device-policy-id <policy-id> --from-file mfa-device-policy.json

  # Update an MFA device policy from stdin
  pingcli mfa device-policies replace --environment-id <env-id> --mfa-device-policy-id <policy-id> --from-file - < mfa-device-policy.json

  # Update an MFA device policy, overriding scalar fields with flags
  # (the authentication method channel objects always come from the file - they cannot be set as flags)
  pingcli mfa device-policies replace --environment-id <env-id> --mfa-device-policy-id <policy-id> --name "Default Policy" --from-file mfa-device-policy.json

Options

  -e, --environment-id string            The PingOne environment ID
  -h, --help                             help for replace
  -f, --from-file string                 Path to a JSON file containing the request body, or "-" to read from stdin.
  -m, --mfa-device-policy-id string      The MFA device policy ID
      --default                          Whether this policy is the environment default MFA device policy
      --ignore-user-lock                 Whether to bypass user lock-out enforcement during MFA
      --name string                      The MFA device policy name
      --new-device-notification string   The notification sent to existing devices when a new device is paired

Options inherited from parent commands

  -C, --config string           The relative or full path to a custom Ping CLI configuration file. (default $HOME/.pingcli/config.yaml)
  -D, --detailed-exitcode       Enable detailed exit code output. (default false) 0 - pingcli command succeeded with no errors or warnings. 1 - pingcli command failed with errors. 2 - pingcli command succeeded with warnings.
  -O, --output-format string    Specify the console output format. (default text) Options are: json, ndjson, ndjson-typed, ndjson-wrapped, text.
  -P, --profile string          The name of a configuration profile to use.
      --debug                   Enable debug output for error messages, including stack traces and transaction IDs. (default false)
      --log-file string         Write logs to a file at the given path. File logging is disabled when not set.
      --log-file-level string   Set the file log level. Options are: DEBUG, INFO, WARN, ERROR. (default DEBUG)
      --log-level string        Set the console log level. Options are: DEBUG, INFO, WARN, ERROR. (default WARN)
      --no-color                Disable text output in color. (default false)
      --query string            JMESPath expression to filter JSON output. Requires -O json, ndjson, ndjson-typed, or ndjson-wrapped. Example: --query 'data[?enabled].name'

More information