io7m | single-page | multi-page
3.16. vm-delete-devices
Previous
3. Command-Line Interface
Up
3.18. vm-export
Next
3.17

# vm-delete

- 3.17. vm-delete
  - 3.17.1. Name
  - 3.17.2. Description
  - 3.17.3. Example

3.17.1

## Name

1
vm-delete - Delete defined virtual machines
3.17.2

## Description

1
The vm-delete command deletes the configuration for a virtual machine. It will not stop any running instance of the given virtual machine, nor will it delete the underlying resources such as ZFS volumes.
2

### 3.17.2.2 Parameters

Parameter | Type | Required | Description
--- | --- | --- | ---
--configuration | Path | false | The path to the configuration file (environment variable: $WAXMILL_CONFIGURATION_FILE)
--verbose | Log Level | false | Set the minimum logging verbosity level.
--machine | UUID | true | The ID of the virtual machine.

3.17.3

## Example

1

### 3.17.3.1 Example

    $ waxmill vm-list
    # ID                                     Name
    800a2dad-3367-4a98-879a-0fac219f55f4     com.io7m.example2
    538a90e4-d50d-4511-8643-ae418279bac4     com.io7m.example
    6730354e-bcba-4636-ab07-ad853c375f7d     com.io7m.example3

    $ waxmill vm-delete --machine 6730354e-bcba-4636-ab07-ad853c375f7d

    $ waxmill vm-list
    # ID                                     Name
    800a2dad-3367-4a98-879a-0fac219f55f4     com.io7m.example2
    538a90e4-d50d-4511-8643-ae418279bac4     com.io7m.example

    $ waxmill vm-delete --machine 6730354e-bcba-4636-ab07-ad853c375f7d
    ERROR com.io7m.waxmill.cmdline.Main: com.io7m.waxmill.exceptions.WXMExceptionNonexistent: The specified machine does not exist.
      Machine: 6730354e-bcba-4636-ab07-ad853c375f7d

    ERROR com.io7m.waxmill.cmdline.Main: Caused by: java.nio.file.NoSuchFileException: /etc/waxmill/vm/6730354e-bcba-4636-ab07-ad853c375f7d.wvmx

3.16. vm-delete-devices
Previous
3. Command-Line Interface
Up
3.18. vm-export
Next
io7m | single-page | multi-page