io7m | single-page | multi-page
3.15. vm-delete-boot-configurations
Previous
3. Command-Line Interface
Up
3.17. vm-delete
Next
3.16

# vm-delete-devices

- 3.16. vm-delete-devices
  - 3.16.1. Name
  - 3.16.2. Description
  - 3.16.3. Example

3.16.1

## Name

1
vm-delete-devices - Delete devices from a virtual machine
3.16.2

## Description

1
The vm-delete-devices removes devices from a given virtual machine. If any of the specified devices are referenced by a boot configuration on the virtual machine, the boot configuration must first either be deleted, or modified such that it no longer refers to the device.
2

### 3.16.2.2 Parameters

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

3.16.3

## Example

1

### 3.16.3.1 Example

    $ waxmill vm-delete-devices --machine 538a90e4-d50d-4511-8643-ae418279bac4 --device-slot 0:10:0
    ERROR com.io7m.waxmill.cmdline.internal.WXMCommandVMDeleteDevice: Device does not exist: 0:10:0

    $ waxmill vm-delete-devices --machine 538a90e4-d50d-4511-8643-ae418279bac4 --device-slot 0:3:0
    INFO com.io7m.waxmill.cmdline.internal.WXMCommandVMDeleteDevice: Deleted device 0:3:0

    $ waxmill vm-delete-devices --machine 538a90e4-d50d-4511-8643-ae418279bac4 --device-slot 0:2:0
    ERROR com.io7m.waxmill.cmdline.internal.WXMCommandVMDeleteDevice: One or more boot configurations are using the device.
      Device:              0:2:0
      Boot configurations: [run]

3.15. vm-delete-boot-configurations
Previous
3. Command-Line Interface
Up
3.17. vm-delete
Next
io7m | single-page | multi-page