Vm Hardware Boot Device APIs

Vm Hardware Boot Device APIs

The Device service provides operations for configuring the device order used when booting a virtual machine. The boot order may be specified using a mixture of device classes and device instances, chosen from among the following:

  • CDROM: Boot from a virtual CD-ROM drive; the device instance(s) will be chosen by the BIOS subsystem.
  • FLOPPY: Boot from a virtual floppy drive; the device instance(s) will be chosen by the BIOS subsystem.
  • DISK: Boot from a virtual disk device; the device instance is specified explicitly in Device.Entry.disks list, and multiple instances may be specified in the list.
  • ETHERNET: Boot from a virtual Ethernet adapter; the device instance is specified explicitly as Device.Entry.nic, and multiple adapters may be specified in the boot order list.

Operations
GET
Get Vm Hardware Boot Device
Returns an ordered list of boot devices for the virtual machine. If the list is empty, the virtual machine uses a default boot sequence.
PUT
Set Vm Hardware Boot Device
Sets the virtual devices that will be used to boot the virtual machine. The virtual machine will check the devices in order, attempting to boot from each, until the virtual machine boots successfully. If the list is empty, the virtual machine will use a default boot sequence. There should be no more than one instance of Device.Entry for a given device type except ETHERNET in the list.