This command creates/deletes/modifies/shows bandwidth groups of the given virtual machine:
VBoxManage bandwidthctl <uuid|vmname> add <name> --type disk|network --limit <megabytes per second>[k|m|g|K|M|G] | set <name> --limit <megabytes per second>[k|m|g|K|M|G] | remove <name> | list [--machinereadable]
The following subcommands are available:
add
, creates a new bandwidth
group of given type.
set
, modifies the limit for an
existing bandwidth group.
remove
, destroys a bandwidth
group.
list
, shows all bandwidth groups
defined for the given VM.
The parameters mean:
The VM UUID or VM Name. Mandatory.
Name of the bandwidth group. Mandatory.
Type of the bandwidth group. Mandatory. Two types are
supported: disk
and
network
. See
Section 5.8, “Limiting bandwidth for disk images” or
Section 6.9, “Limiting bandwidth for network I/O” for a description of a
particular type.
Specifies the limit for the given group. Can be changed
while the VM is running. The default unit is megabytes per
second. The unit can be changed by specifying one of the
following suffixes: k
for kilobits/s, m
for megabits/s, g
for gigabits/s, K
for kilobytes/s, M
for megabytes/s, G
for gigabytes/s.
The network bandwidth limits apply only to the traffic being sent by virtual machines. The traffic being received by VMs is unlimited.
To remove a bandwidth group it must not be referenced by any disks or adapters in running VM.