Previous page

Next page

Locate page in Contents

Print this page

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