Managed Object - HostBootDeviceSystem

Property of: HostConfigManager
See also: HostBootDeviceInfo
Since: VI API 2.5

Managed Object Description

The HostBootDeviceSystem managed object provides methods to query and update a host boot device configuration.

Properties

Name	Type	Description
None

Methods

Methods defined in this Managed Object
QueryBootDevices, UpdateBootDevice

QueryBootDevices

Retrieves a list of the available boot devices for the host system.

Required Privileges: System.Read

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the HostBootDeviceSystem used to make the method call.

Return Value

Type	Description
HostBootDeviceInfo	The boot device information for the host. The returned object has a list of HostBootDevice data objects; each boot device object defines a description and a key to identify the device. The order of devices in the list is unpredictable. The returned HostBootDeviceInfo data object also contains the key of the current boot device.

Faults

Type	Description
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="QueryBootDevices" type="vim25:QueryBootDevicesRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="QueryBootDevicesResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="vim25:HostBootDeviceInfo" minOccurs="0"/>
               </sequence>
            </complexType>
         </element>

UpdateBootDevice

Sets the current boot device for the host system.

Required Privileges: Host.Config.Maintenance

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the HostBootDeviceSystem used to make the method call.
key	xsd:string	The key of the HostBootDevice from which the host will boot.

Return Value

Type	Description
None

Faults

Type	Description
NotSupported	Thrown if the host does not support updating bootDevices.
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="UpdateBootDevice" type="vim25:UpdateBootDeviceRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="UpdateBootDeviceResponse">
            <complexType/>
         </element>