Network Adapter Management Parameters
This group of parameters is used to manage virtual network adapters in a virtual machine.
Syntax
prlctl set ID|VM_name --device-add net --type shared
[--mac addr][--enable|--disable][--connect|--disconnect]
prlctl set ID|VM_name --device-add net --type host --net_id network_id
[--mac addr][--enable|--disable][--connect|--disconnect]
prlctl set ID|VM_name --device-add net --type bridged --iface name
[--mac addr][--enable|--disable] [--connect|--disconnect]
prlctl set ID|VM_name --device-set netN --type shared
[--mac addr][--enable|--disable][--connect|--disconnect]
prlctl set ID|VM_name --device-set netN --type host --net_id network_id
[--mac addr][--enable|--disable][--connect|--disconnect]
prlctl set ID|VM_name --device-set netN --type bridged
--iface name [--mac addr|auto][--enable|--disable]
[--connect|--disconnect]
Parameters
Name
|
Description
|
ID
|
The virtual machine ID.
|
VM_name
|
The virtual machine name.
|
--device-add
|
Adds a new virtual network adapter to the virtual machine.
|
--device-set
|
Used to configure an existing virtual network adapter.
|
net
|
Specifies the virtual device type to add (in this instance, a virtual network adapter).
|
net N
|
The name of the virtual network adapter to modify. To obtain the list of the available adapters, use the prlctl list command with the --info option.
|
--type shared|host|bridged
|
Sets the networking mode for the virtual network adapter:
shared -- Shared networking. Select this option if you wish to enable Network Address Translation (NAT) for the adapter. The adapter will share the IP address with the host computer when communicating with external networks.host -- Host-only networking. Select this option if you wish the virtual machine to communicate only with the host computer and other virtual machines included in the same network. Access to external networks is not allowed.bridged -- Bridged networking. The adapter is bound to the specified physical network adapter. The virtual machine will appear as a standalone computer on the network.
|
--iface name
|
Used with the bridged networking mode (see above). Specifies the name of the physical network adapter to which the virtual adapter should be bound.
|
--net_id network_id
|
Used with the host-only networking mode (see above). Specifies the name of virtual network to which the virtual adapter should be bound.
|
--mac addr
|
The MAC address to be assigned to the virtual network adapter. If this option is omitted, the MAC address will be generated automatically.
|
--mac addr |auto
|
Specifies the MAC address to assign to an existing network adapter. Specify a desired MAC address using the addr parameter value or use the auto option to re-generate the existing address automatically.
|
--enable
|
Enables the virtual network card. All newly created network adapters are enabled by default (provided the --disable option is omitted).
|
--disable
|
Disables virtual network adapter. The adapter itself is not removed from the virtual machine configuration. Please note that a disabled virtual network adapter can only be enabled in a stopped virtual machine.
|
--connect
|
Automatically connect the virtual network adapter during the virtual machine startup process.
|
--disconnect
|
Do not automatically connect the virtual network adapter during the virtual machine startup process.
|
Links
General Syntax, Virtual Device Management
|