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
|
host
|
bridged
[
--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
|
host
[
--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.
|
--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
|