`multipass get` command (preview)
[not available yet]
multipass get command provides a way to obtain Multipass’s settings. For example:
$ multipass get local.driver qemu
Available settings are documented in the reference.
When used without arguments, it displays all available settings as a list of
$ multipass get client.gui.autostart=true client.gui.hotkey=Ctrl+Alt+U client.primary-name=primary
--keys option, it lists only settings keys:
$ multipass get --keys client.gui.autostart client.gui.hotkey client.primary-name
In all cases,
get returns only settings that are available at the moment when it is executed.
This command can also be given positional arguments, restricting what settings are to be retrieved. Such arguments can take the form of either plain keys (e.g.
client.primary-name) or key wildcards (e.g.
multipass get filters the settings according to the positional arguments it is given, returning only the subset of available settings that satisfy them:
$ multipass get client.gui.* client.gui.autostart=true client.gui.hotkey=Ctrl+Alt+U
$ multipass get client.gui.* local.driver client.gui.autostart=true client.gui.hotkey=Ctrl+Alt+U local.driver=qemu
When only one setting satisfies the input arguments, its key is omitted and only its value is printed, unless
--keys is also provided (in which case only the key is printed, still):
$ multipass get client.gui.autostart true
If no setting matches the arguments, multipass will complain that it cannot recognize the settings key(s).
--raw option, values are printed in raw format. For now this affects only the representation of empty values:
$ multipass get --raw client.primary-name $ multipass get client.primary-name <empty>
multipass help get for a quick reference:
$ multipass help get Usage: multipass get [options] [<arg> ...] Get the configuration setting(s) corresponding to the given key(s), or all settings if no key is specified. Some common settings keys are: - client.gui.autostart - local.driver - local.privileged-mounts Use `multipass get --keys` to obtain the full list of available settings at any given time. Options: -h, --help Display this help -v, --verbose Increase logging verbosity. Repeat the 'v' in the short option for more detail. Maximum verbosity is obtained with 4 (or more) v's, i.e. -vvvv. --raw Output in raw format. For now, this affects only the representation of empty values (i.e. "" instead of "<empty>"). --keys List available settings keys. This outputs the whole list of currently available settings keys, or a matching subset when <arg>... is(are) provided Arguments: arg Setting(s) key(s), i.e. path(s) to the setting(s) whose configured value(s) should be obtained.
Last updated 6 months ago.