Struct VirtualUsb 

pub struct VirtualUsb {
    pub virtual_device_: VirtualDevice,
    pub connected: bool,
    pub vendor: Option<i32>,
    pub product: Option<i32>,
    pub family: Option<Vec<String>>,
    pub speed: Option<Vec<String>>,
}

The VirtualUSB data object describes the USB device configuration for a virtual machine.

You can attach a USB device to an ESX host. The device is available to only one virtual machine at a time. When you remove the device from the virtual machine, it becomes available to other virtual machines located on the host. You can add up to 20 USB devices to a virtual machine. Virtual USB support requires virtual machine hardware version 7 or later.

The VirtualUSB object represents either a configuration to be applied to the virtual machine or the current device configuration on the virtual machine.

• To configure a USB connection for the virtual machine, add a VirtualUSB object to the VirtualDeviceConfigSpec. Use USB backing (VirtualUSBUSBBackingInfo) to establish a connection with a virtual machine that will remain on the host to which the USB device is attached. The vSphere Server does not support vMotion for standard USB backing. To configure vMotion support for a virtual machine with a USB connection, use remote host backing for the USB connection (VirtualUSBRemoteHostBackingInfo).

  To configure a USB device for a virtual machine, the virtual machine must have a USB controller. To add a controller, include a VirtualUSBController object in the virtual device specification for your virtual machine configuration. You can add only one USB controller to a virtual machine.

• To determine USB device configuration status for the virtual machine, check the virtual hardware device list (VirtualHardware.VirtualHardware.device). The presence of the VirtualUSB object in the hardware device list indicates that the virtual machine is configured to use a USB device. The VirtualUSB.connected property indicates whether the virtual machine is connected to the device.

To determine the USB options available on the host, use the EnvironmentBrowser.QueryConfigOption method to retrieve the virtual machine configuration. The presence of the VirtualUSBOption object in the retrieved configuration (VirtualMachineConfigOption.VirtualMachineConfigOption.hardwareOptions.VirtualHardwareOption.virtualDeviceOption) indicates that the host supports USB connections.

The following operations will disconnect a USB device, losing data if data transfer is in progress over the USB connection.

• Hot add of memory, CPU, or PCI devices. A hot add operation disconnects only USB devices for virtual machines that use a local connection to the device (VirtualUSBUSBBackingInfo).
• Suspend and resume on a virtual machine.
• vMotion of a virtual machine with a USB connection, if you are not using remote host USB backing.

The following services do not support USB connections.

• Fault Tolerance virtual machines cannot use USB devices.
• DPM (Distributed Power Management) will put a host into standby, regardless of any connections to USB devices on the host.
• DRS (Distributed Resource Scheduling) may power-off hosts that have USB connections to virtual machines.

How to access

• VirtualMachine::config.hardware.device?[*]→VirtualUsb
• StoragePod::pod_storage_drs_entry.recommendation?[*].action?[*]→StoragePlacementAction.relocate_spec.device_change?[*].device→VirtualUsb
• StoragePod::pod_storage_drs_entry.recommendation?[*].action?[*]→StorageMigrationAction.relocate_spec.device_change?[*].device→VirtualUsb
• StoragePod::pod_storage_drs_entry.recommendation?[*].action?[*]→PlacementAction.relocate_spec?.device_change?[*].device→VirtualUsb
• StoragePod::pod_storage_drs_entry.recommendation?[*].action?[*]→ClusterClusterInitialPlacementAction.config_spec?.device_change?[*].device→VirtualUsb
• StoragePod::pod_storage_drs_entry.action_history?[*].action→StoragePlacementAction.relocate_spec.device_change?[*].device→VirtualUsb
• ClusterComputeResource::action_history.action→StoragePlacementAction.relocate_spec.device_change?[*].device→VirtualUsb
• ClusterComputeResource::action_history.action→StorageMigrationAction.relocate_spec.device_change?[*].device→VirtualUsb
• ClusterComputeResource::action_history.action→PlacementAction.relocate_spec?.device_change?[*].device→VirtualUsb
• ClusterComputeResource::action_history.action→ClusterClusterInitialPlacementAction.config_spec?.device_change?[*].device→VirtualUsb

(10 of 65 paths)

Fields

virtual_device_: VirtualDevice

connected: bool

Flag indicating whether the device is currently connected.

The virtual machine is not connected to the device if the autoconnect pattern specified in the USB device backing (VirtualDeviceDeviceBackingInfo.VirtualDeviceDeviceBackingInfo.deviceName) can not be satisfied, either because there is no such device, or the matching device is not available. Valid only while the virtual machine is running.

vendor: Option<i32>

Vendor ID of the USB device.

product: Option<i32>

Product ID of the USB device.

family: Option<Vec<String>>

Device class families.

For possible values see VirtualMachineUsbInfoFamily_enum.

speed: Option<Vec<String>>

Device speeds detected by server.

For possible values see VirtualMachineUsbInfoSpeed_enum.

Trait Implementations

impl Debug for VirtualUsb

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Deref for VirtualUsb

type Target = VirtualDevice

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl DerefMut for VirtualUsb

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl Deserialize for VirtualUsb

fn begin(out: &mut Option<Self>) -> &mut dyn Visitor

The only correct implementation of this method is:

impl Serialize for VirtualUsb

fn begin(&self) -> Fragment<'_>

impl VimObjectTrait for VirtualUsb

fn as_vim_object_ref<'a>(&'a self) -> &'a dyn VimObjectTrait

fn data_type(&self) -> StructType

impl VirtualDeviceTrait for VirtualUsb

fn get_virtual_device(&self) -> &VirtualDevice

Get a reference to the VirtualDevice parent struct

fn get_virtual_device_mut(&mut self) -> &mut VirtualDevice

Get a mutable reference to the VirtualDevice parent struct

impl DataObjectTrait for VirtualUsb