# metalcloud-cli vm

Manage virtual machines lifecycle and configuration

## Synopsis

Comprehensive virtual machine management commands for controlling VM power states,
configuration updates, and monitoring. Supports operations like start, stop, reboot,
status checking, and configuration updates through JSON files or pipes.

Available Commands:
  get            Retrieve detailed VM information and configuration
  power-status   Check current power state of a VM
  start          Power on a VM
  shutdown       Gracefully shutdown or force stop a VM  
  reboot         Restart a VM
  update         Update VM configuration from JSON file or pipe
  console-info   Get remote console connection details

Examples:
  metalcloud-cli vm get 12345
  metalcloud-cli vm start 12345
  metalcloud-cli vm update 12345 --config-source config.json
  cat vm-config.json | metalcloud-cli vm update 12345 --config-source pipe

### Options

```
  -h, --help   help for vm
```

### Options inherited from parent commands

```
  -k, --api_key string         MetalCloud API key
  -c, --config string          Config file path
  -d, --debug                  Set to enable debug logging
  -e, --endpoint string        MetalCloud API endpoint
  -f, --format string          Output format. Supported values are 'text','csv','md','json','yaml'. (default "text")
  -i, --insecure_skip_verify   Set to allow insecure transport
  -l, --log_file string        Log file path
  -v, --verbosity string       Log level verbosity (default "INFO")
```

### SEE ALSO

* [metalcloud-cli](/content/configuration/cli/metalcloud-cli.md)	 - MetalCloud CLI
* [metalcloud-cli vm console-info](/content/configuration/cli/metalcloud-cli_vm_console-info.md)	 - Get VM remote console connection details
* [metalcloud-cli vm get](/content/configuration/cli/metalcloud-cli_vm_get.md)	 - Retrieve detailed VM information and configuration
* [metalcloud-cli vm power-status](/content/configuration/cli/metalcloud-cli_vm_power-status.md)	 - Check current power state of a VM
* [metalcloud-cli vm reboot](/content/configuration/cli/metalcloud-cli_vm_reboot.md)	 - Restart a virtual machine
* [metalcloud-cli vm shutdown](/content/configuration/cli/metalcloud-cli_vm_shutdown.md)	 - Gracefully shutdown or force stop a VM
* [metalcloud-cli vm start](/content/configuration/cli/metalcloud-cli_vm_start.md)	 - Power on a virtual machine
* [metalcloud-cli vm update](/content/configuration/cli/metalcloud-cli_vm_update.md)	 - Update VM configuration from JSON file or pipe

#### Auto generated by spf13/cobra on 11-Aug-2025